基本能力
产品定位
codemcp 旨在将 Claude Desktop 转变为结对编程助手,帮助开发者在本地代码库上实现功能、修复错误和进行重构。
核心功能
- 与 Claude Pro 集成:使用 Anthropic 的 Claude Pro 订阅服务,避免高昂的 API 费用。
- 安全的代理 AI:提供有限的工具集,确保 AI 不会滥用权限,并通过 Git 版本控制支持代码更改的回滚。
- IDE 无关性:支持与任何 IDE 配合使用,开发者可以在 Claude 完成更改后使用自己喜欢的工具进行审查和进一步编辑。
适用场景
- 功能实现:让 Claude 直接在本地代码库上实现新功能。
- 错误修复:快速定位和修复代码中的错误。
- 代码重构:帮助开发者进行代码重构,提高代码质量。
工具列表
- Git:用于版本控制和代码更改的回滚。
- uv:用于安装和管理 codemcp。
- pip:替代安装方式,适用于全局 Python 环境。
常见问题解答
- Git 未找到:确保 Git 已安装并添加到系统 PATH 中,必要时重启机器。
- 日志查看:在 Claude Desktop 的设置中查看日志以调试问题。
- 版本控制:可以通过修改配置中的分支名称(如
prod
或main
)来切换版本。
使用教程
使用依赖
安装教程
- 使用 uv 安装:
json
{
"mcpServers": {
"codemcp": {
"command": "/Users/<username>/.local/bin/uvx",
"args": [
"--from",
"git+https://github.com/ezyang/codemcp@prod",
"codemcp"
]
}
}
} - 使用 pip 安装:
bash
pip install git+https://github.com/ezyang/codemcp@prod
配置claude_desktop_config.json
:
json
{
"mcpServers": {
"codemcp": {
"command": "python",
"args": ["-m", "codemcp"]
}
}
} - 重启 Claude Desktop。
调试方式
- 查看日志:在 Claude Desktop 的设置中查看
codemcp
的日志。 - 运行服务器:
bash
codemcp serve
可自定义端口和 CORS:
bash
codemcp serve --host 0.0.0.0 --port 8765 --cors-origin https://claude.ai - 检查 Git 配置:确保 Git 已正确安装并添加到 PATH。