Aider MCP Server

🚀 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
}

工具介绍

可用工具

1. 文件管理

   • file-manager/list-files：列出指定目录下的所有文件。
   • file-manager/read-file：读取特定文件的内容。
   • file-manager/write-file：将内容写入指定文件。

2. 版本控制

   • git-status：获取 git 仓库的状态信息，包括未跟踪、已修改和已删除的文件。
   • git-commit：对指定变更进行提交。
   • git-push：将代码推送到远程仓库。

3. 代码操作

   • 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

开发

本地开发步骤

1. 克隆代码库：

   git clone https://github.com/yourusername/aider-mcp-server.git
   cd aider-mcp-server
   

2. 安装依赖项并启动开发服务器：

   pip install -e .
   python -m aider_mcp --dev
   

📄 许可证

本项目采用 Unlicense 协议，源代码和文档均可自由使用、修改和分发。