MCP-CodeSavant

CodeSavant 是一个正在开发中的项目。

CodeSavant 是一个模型上下文协议 (MCP) 服务器，提供代码操作、执行和版本控制功能。它允许 AI 助手读取、写入和执行代码，同时维护更改历史记录。

功能

• 读取和写入代码文件，支持行级别的操作
• 在多种编程语言（Python、Node.js）中执行代码
• 在受控环境中执行 shell 命令
• 使用版本控制跟踪和管理代码更改
• 在代码文件中搜索
• 恢复到代码的先前版本

安装

1. 克隆存储库：

git clone https://github.com/twolven/mcp-codesavant.git
cd mcp-codesavant

2. 安装所需的依赖项：

pip install -r requirements.txt

3. 将服务器配置添加到您的 Claude Desktop config.json：

{
  "mcpServers": {
    "codesavant": {
      "command": "python",
      "args": ["path/to/codesavant.py"]
    }
  }
}

目录结构

服务器创建和管理以下目录结构：

workspaces/
├── project1/
│   ├── .code_history.json
│   └── [代码文件]
├── project2/
│   ├── .code_history.json
│   └── [代码文件]
└── ...

工具参考

详细用法

1. read_code_file

读取代码文件的内容，可以选择搜索特定部分。

{
    "project": "string",     // 项目名称
    "path": "string",        // 相对于项目工作区的文件路径
    "search": "string"       // (可选) 要在文件中搜索的文本/模式
}

响应：

{
    "success": true,
    "timestamp": 1234567890,
    "data": {
        "content": "string",      // 文件内容
        "start_line": number,     // (仅在使用搜索时) 找到部分的起始行
        "end_line": number       // (仅在使用搜索时) 找到部分的结束行
    }
}

2. write_code_file

写入或更新代码文件中的特定行。

{
    "project": "string",     // 项目名称
    "path": "string",        // 相对于工作区的文件路径
    "content": "string",     // 要写入的内容（仅更改的行）
    "start_line": number,    // 更改的起始行号
    "end_line": number      // (可选) 更改的结束行号
}

响应：

{
    "success": true,
    "timestamp": 1234567890,
    "data": {
        "diff": {
            "changes": [           // 更改列表
                [string, number, number, number, number]  // (类型, 旧起始行, 旧结束行, 新起始行, 新结束行)
            ],
            "timestamp": number    // 更改时间
        }
    }
}

3. get_code_history

获取代码文件的更改历史记录。

{
    "path": "string"        // 相对于工作区的文件路径
}

响应：

{
    "success": true,
    "timestamp": 1234567890,
    "data": {
        "history": [
            {
                "changes": [       // 更改列表
                    [string, number, number, number, number]
                ],
                "timestamp": number
            }
        ]
    }
}

4. execute_code_command

执行与代码相关的 shell 命令。

{
    "command": "string",     // 要执行的 shell 命令
    "timeout": number       // (可选) 命令超时时间，以秒为单位（默认值：30）
}

响应：

{
    "success": true,
    "timestamp": 1234567890,
    "data": {
        "state": "success|error|timeout|cancelled",
        "output": "string",        // 命令输出
        "error": "string",         // 错误消息（如果有）
        "runtime": number,         // 执行时间，以秒为单位
        "exit_code": number       // 命令退出代码
    }
}

5. execute_code

以指定的语言执行代码。

{
    "code": "string",        // 要执行的代码
    "language": "string",    // 编程语言（“python”或“node”）
    "timeout": number       // (可选) 执行超时时间，以秒为单位（默认值：30）
}

响应：

{
    "success": true,
    "timestamp": 1234567890,
    "data": {
        "state": "success|error|timeout|cancelled",
        "output": "string",        // 代码执行输出
        "error": "string",         // 错误消息（如果有）
        "runtime": number,         // 执行时间，以秒为单位
        "exit_code": number       // 执行退出代码
    }
}

6. revert_to_version

将代码文件恢复到特定版本。

{
    "path": "string",        // 相对于工作区的文件路径
    "timestamp": number     // 要恢复到的版本的时间戳
}

响应：

{
    "success": true,
    "timestamp": 1234567890,
    "data": {
        "diff": {
            "changes": [           // 更改列表
                [string, number, number, number, number]
            ],
            "timestamp": number    // 恢复时间
        }
    }
}

7. read_code_file_lines

从代码文件中读取特定行。

{
    "project": "string",     // 项目名称
    "path": "string",        // 相对于项目工作区的文件路径
    "start_line": number,    // 要读取的起始行号
    "end_line": number      // (可选) 要读取的结束行号
}

响应：

{
    "success": true,
    "timestamp": 1234567890,
    "data": {
        "content": "string"        // 指定行的内容
    }
}

错误处理

服务器提供以下格式的详细错误响应：

{
    "success": false,
    "timestamp": 1234567890,
    "data": null,
    "error": "错误消息"
}

错误类型包括：

• CodeFileError: 文件操作错误
• CodeValidationError: 代码验证错误
• CodeExecutionError: 代码执行错误

语言支持

当前支持代码执行的语言：

• Python（使用系统 Python 解释器）
• Node.js（使用 node 命令）

每种语言的执行都会在工作区目录中创建一个临时文件，并使用相应的解释器执行它。

贡献

1. Fork 存储库
2. 创建您的功能分支
3. 提交您的更改
4. 推送到分支
5. 创建一个新的 Pull Request

许可证

此项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

作者

Todd Wolven - (https://github.com/twolven)

致谢

• 由 Anthropic 的模型上下文协议 (MCP) 构建
• 为与 Anthropic 的 Claude 一起使用而开发