🚀 Aider MCP 服务器
Aider MCP 服务器是一个模型上下文协议（MCP）服务器，它允许 Claude 和其他 MCP 客户端连接到 Aider，从而实现高效的文件编辑能力。
🚀 快速开始
此 MCP 服务器弥合了 AI 助手（如 Claude）与 Aider 强大的文件编辑功能之间的差距。它通过 Model Context Protocol 提供了一个标准化接口，让 Claude 能使用 Aider 的能力编辑现有文件、创建新文件、提取代码块、获取 git 状态信息、检查 Aider 安装状态以及访问并使用 Aider 的配置系统。
✨ 主要特性
- 使用 Aider 的能力编辑现有文件
- 创建包含内容的新文件
- 从 Markdown 文本中提取代码块
- 获取 git 状态信息
- 检查 Aider 安装状态
- 访问并使用 Aider 的配置系统
📦 安装指南
先决条件
- Python 3.8 或更高版本
- 已安装 Aider（
pip install aider-chat） - OpenAI 或 Anthropic 的 API 密钥（具体取决于使用的模型）
- Git 环境变量已配置（用于仓库路径）
安装方式
方式一：使用 pip 安装最新稳定版本
pip install aider-mcp
方式二：从源码安装
git clone https://github.com/yourusername/aider-mcp-server.git
cd aider-mcp-server
pip install -e .
💻 使用示例
启动服务器
uvx aider-mcp --port 3000
通过命令行运行
python -m aider_mcp --repo-path /path/to/repo
📚 详细文档
配置示例
在环境中设置变量
- 设置
REPO_PATH指定仓库路径：export REPO_PATH=/path/to/repo - 设置
AIDER_MCP_VERBOSE启用调试日志：export AIDER_MCP_VERBOSE=true
在配置文件中设置
创建或编辑 ~/.config/aider-mcp/config.json 文件，添加以下内容：
{
"repoPath": "/path/to/repo",
"aiderPath": "/path/to/aider",
"verbose": true
}
工具介绍
可用工具
-
文件管理
file-manager/list-files：列出指定目录下的所有文件。file-manager/read-file：读取特定文件的内容。file-manager/write-file：将内容写入指定文件。
-
版本控制
git-status：获取 git 仓库的状态信息，包括未跟踪、已修改和已删除的文件。git-commit：对指定变更进行提交。git-push：将代码推送到远程仓库。
-
代码操作
code-analyzer/highlight-code：对代码片段进行语法高亮。code-generator/generate-function：根据描述生成函数代码。code-formatter/format-file：格式化指定文件的代码。
环境变量
基本设置
REPO_PATH：指定默认仓库路径，默认为当前目录。AIDER_MCP_VERBOSE：启用详细日志输出，可选值为 true 或 false。
高级配置
EDITOR: 设置默认编辑器，如 vim 或 VSCode。BRANCH_NAME: 指定默认分支名称，通常为 main 或 master。COMMIT_MESSAGE: 默认提交信息模板，支持变量替换。
调试
使用 MCP 监视器调试
npx @modelcontextprotocol/inspector uvx aider-mcp
指定仓库路径启动监视器
npx @modelcontextprotocol/inspector --repo-path=/path/to/repo
开发
本地开发步骤
- 克隆代码库：
git clone https://github.com/yourusername/aider-mcp-server.git cd aider-mcp-server - 安装依赖项并启动开发服务器：
pip install -e . python -m aider_mcp --dev
📄 许可证
本项目采用 Unlicense 协议，源代码和文档均可自由使用、修改和分发。