ReCode-MCP


English | 中文

---

中文

ReCode-MCP 是一个 Model Context Protocol (MCP) 服务器，为 AI 助手提供对 ReCode VS Code 扩展 管理的代码变更历史的访问能力。

$3

- 🔍 查询历史 - 按时间、文件路径查询代码变更记录
- 📝 查看 Diff - 获取任意变更记录的详细差异
- 🔎 内容搜索 - 搜索特定代码何时被添加或删除
- 📊 统计分析 - 查看变更频率、文件活跃度等统计
- 🗂️ 多工作区 - 支持同时管理多个项目的历史

$3

``bash


克隆仓库

git clone https://github.com/yourusername/ReCode-MCP.git
cd ReCode-MCP

安装依赖

npm install

构建

npm run build
`

$3

#### Claude Desktop

在 ~/Library/Application Support/Claude/claude_desktop_config.json 中添加：

`json
{
"mcpServers": {
"recode": {
"command": "node",
"args": ["/path/to/ReCode-MCP/dist/index.js"]
}
}
}
`

#### 自定义配置

创建 ~/.config/recode-mcp/config.json：

`json
{
"workspaces": [
"/Users/you/projects/myapp"
],
"autoDiscoverWorkspaces": true,
"discoveryPaths": [
"/Users/you/projects"
],
"maxRecordsPerQuery": 1000,
"logLevel": "info"
}
`

$3

#### query_history
查询代码变更历史。

`
参数：
- workspace_path (必需): 工作区路径
- file_path (可选): 特定文件路径
- since (可选): 开始时间 (ISO 8601)
- until (可选): 结束时间 (ISO 8601)
- limit (可选): 返回数量限制，默认 50
`

#### get_change_diff
获取特定变更的 diff 内容。

`
参数：
- workspace_path (必需): 工作区路径
- record_id (必需): 变更记录 ID
- format (可选): 'unified' 或 'side-by-side'
`

#### search_changes
按内容搜索变更记录。

`
参数：
- workspace_path (必需): 工作区路径
- search_query (必需): 搜索关键词
- search_in (可选): 'added' | 'removed' | 'both'
- limit (可选): 返回数量限制
`

#### get_statistics
获取工作区统计信息。

`
参数：
- workspace_path (必需): 工作区路径
- time_range (可选): 'today' | 'week' | 'month' | 'all'
`

#### list_workspaces
列出所有发现的 ReCode 工作区。

`
参数：
- discovery_paths (可选): 额外搜索路径
`

$3

与 AI 助手对话：

`
用户：最近一小时我改了什么代码？
AI：[使用 query_history 工具查询]

用户：查看第 42 条变更的具体内容
AI：[使用 get_change_diff 工具获取 diff]

用户：搜索包含 "authentication" 的变更
AI：[使用 search_changes 工具搜索]
`

$3

- Node.js >= 18
- 项目中已安装 ReCode VS Code 扩展
- 项目中存在 .recode/history.db 文件

---

English

ReCode-MCP is a Model Context Protocol (MCP) server that provides AI assistants with access to code change history managed by the ReCode VS Code extension.

$3

- 🔍 Query History - Query code change records by time and file path
- 📝 View Diff - Get detailed diff of any change record
- 🔎 Content Search - Search when specific code was added or removed
- 📊 Statistics - View change frequency, file activity stats
- 🗂️ Multi-workspace - Support multiple projects simultaneously

$3

`bash


Clone repository

git clone https://github.com/yourusername/ReCode-MCP.git
cd ReCode-MCP

Install dependencies

npm install

Build

npm run build
`

$3

#### Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

`json
{
"mcpServers": {
"recode": {
"command": "node",
"args": ["/path/to/ReCode-MCP/dist/index.js"]
}
}
}
`

#### Custom Configuration

Create ~/.config/recode-mcp/config.json:

`json
{
"workspaces": [
"/Users/you/projects/myapp"
],
"autoDiscoverWorkspaces": true,
"discoveryPaths": [
"/Users/you/projects"
],
"maxRecordsPerQuery": 1000,
"logLevel": "info"
}
`

$3

#### query_history
Query code change history.

`
Parameters:
- workspace_path (required): Workspace path
- file_path (optional): Specific file path
- since (optional): Start time (ISO 8601)
- until (optional): End time (ISO 8601)
- limit (optional): Result limit, default 50
`

#### get_change_diff
Get diff content of a specific change.

`
Parameters:
- workspace_path (required): Workspace path
- record_id (required): Change record ID
- format (optional): 'unified' or 'side-by-side'
`

#### search_changes
Search changes by content.

`
Parameters:
- workspace_path (required): Workspace path
- search_query (required): Search keyword
- search_in (optional): 'added' | 'removed' | 'both'
- limit (optional): Result limit
`

#### get_statistics
Get workspace statistics.

`
Parameters:
- workspace_path (required): Workspace path
- time_range (optional): 'today' | 'week' | 'month' | 'all'
`

#### list_workspaces
List all discovered ReCode workspaces.

`
Parameters:
- discovery_paths (optional): Additional search paths
`

$3

Chat with AI assistant:

`
User: What code did I change in the last hour?
AI: [Uses query_history tool]

User: Show me the details of change #42
AI: [Uses get_change_diff tool]

User: Search for changes containing "authentication"
AI: [Uses search_changes tool]
`

$3

- Node.js >= 18
- ReCode VS Code extension installed
- .recode/history.db` file exists in project

---

📄 License

MIT License