codemcp

codemcp

site icon
2025.04.20 1145
Python结对编程助手代码管理AI 开发工具开发效率
codemcp 是一个将 Claude Desktop 转变为结对编程助手的工具。它允许用户直接让 Claude 在本地代码库上实现功能、修复错误和进行重构,而无需在聊天窗口中复制粘贴代码。codemcp 提供了安全的代理 AI 功能,通过有限的工具集和 Git 版本控制确保代码更改可回滚,同时支持与任何 IDE 配合使用。
View on GitHub

Overview

基本能力

产品定位

codemcp 旨在将 Claude Desktop 转变为结对编程助手,帮助开发者在本地代码库上实现功能、修复错误和进行重构。

核心功能

  1. 与 Claude Pro 集成:使用 Anthropic 的 Claude Pro 订阅服务,避免高昂的 API 费用。
  2. 安全的代理 AI:提供有限的工具集,确保 AI 不会滥用权限,并通过 Git 版本控制支持代码更改的回滚。
  3. IDE 无关性:支持与任何 IDE 配合使用,开发者可以在 Claude 完成更改后使用自己喜欢的工具进行审查和进一步编辑。

适用场景

  1. 功能实现:让 Claude 直接在本地代码库上实现新功能。
  2. 错误修复:快速定位和修复代码中的错误。
  3. 代码重构:帮助开发者进行代码重构,提高代码质量。

工具列表

  1. Git:用于版本控制和代码更改的回滚。
  2. uv:用于安装和管理 codemcp。
  3. pip:替代安装方式,适用于全局 Python 环境。

常见问题解答

  1. Git 未找到:确保 Git 已安装并添加到系统 PATH 中,必要时重启机器。
  2. 日志查看:在 Claude Desktop 的设置中查看日志以调试问题。
  3. 版本控制:可以通过修改配置中的分支名称(如 prodmain)来切换版本。

使用教程

使用依赖

  1. 安装 uv
  2. 安装 Git

安装教程

  1. 使用 uv 安装json { "mcpServers": { "codemcp": { "command": "/Users/<username>/.local/bin/uvx", "args": [ "--from", "git+https://github.com/ezyang/codemcp@prod", "codemcp" ] } } }
  2. 使用 pip 安装bash pip install git+https://github.com/ezyang/codemcp@prod 配置 claude_desktop_config.jsonjson { "mcpServers": { "codemcp": { "command": "python", "args": ["-m", "codemcp"] } } }
  3. 重启 Claude Desktop。

调试方式

  1. 查看日志:在 Claude Desktop 的设置中查看 codemcp 的日志。
  2. 运行服务器: bash codemcp serve 可自定义端口和 CORS: bash codemcp serve --host 0.0.0.0 --port 8765 --cors-origin https://claude.ai
  3. 检查 Git 配置:确保 Git 已正确安装并添加到 PATH。

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。