Aider MCP 服务器

一个模型上下文协议 (MCP) 服务器，允许 Claude 和其他 MCP 客户端连接到 Aider，以实现高效的文件编辑功能。

概述

此 MCP 服务器弥合了 AI 助手（如 Claude）与 Aider 强大的文件编辑功能之间的差距。它通过模型上下文协议提供了一个标准化的接口，允许 Claude：

• 使用 Aider 的功能编辑现有文件
• 创建包含内容的新文件
• 从 markdown 文本中提取代码块
• 获取 git 状态信息
• 检查 Aider 安装状态
• 访问和使用 Aider 的配置系统

前提条件

• Python 3.8 或更高版本
• 已安装 Aider (pip install aider-chat)
• OpenAI 或 Anthropic 的 API 密钥（取决于您希望 Aider 使用的模型）
• 用于文件编辑的 Git 仓库

安装

您可以通过以下几种方式安装 Aider MCP 服务器：

使用 UV (推荐)

如果您已安装 uv：

# 如果您没有安装 uv，请安装它
curl -fsSL https://astral.sh/uv/install.sh | bash

# 使用 uvx 直接运行（无需安装）
uvx aider-mcp

使用 PIP

# 安装包
pip install aider-mcp

# 运行服务器
aider-mcp

用法

Aider MCP 服务器默认在 stdio 上以 MCP 协议模式运行，该模式专为与 Claude Desktop 和 Cursor IDE 等 MCP 客户端直接集成而设计。

# 使用 uvx 直接运行（推荐）
uvx aider-mcp

# 指定仓库路径
uvx aider-mcp --repo-path=/path/to/your/repo

# 指定自定义 Aider 可执行文件路径
uvx aider-mcp --aider-path=/path/to/aider

# 使用环境变量
REPO_PATH=/path/to/your/repo uvx aider-mcp

命令行选项

您可以使用以下环境变量或命令行参数自定义服务器：

• --aider-path: Aider 可执行文件的路径（默认值："aider"，自动搜索 PATH）
• --repo-path: git 仓库的路径（默认值：当前目录）
• --config-file: 自定义 Aider 配置文件的路径
• --env-file: 自定义 .env 文件的路径
• --verbose, -v: 启用详细输出

客户端配置

Claude Desktop

将以下内容添加到您的 Claude Desktop 配置文件中：

{
  "mcpServers": {
    "aider-mcp": {
      "command": "uvx",
      "args": [
        "aider-mcp",
        "--repo-path", "/path/to/your/repo"
      ]
    }
  }
}

Cursor IDE

要与 Cursor IDE 集成：

1. 打开 Cursor 设置
2. 导航到 Features > MCP Servers
3. 点击 Add new MCP server
4. 输入以下配置：

   name: aider-mcp
   type: command
   command: uvx aider-mcp --repo-path=/path/to/your/repo
   

5. 配置完成后，请确保您处于 Composer 中的 Agent 模式以使用 MCP 工具

Aider 配置支持

此 MCP 服务器支持 Aider 的配置系统，允许您：

1. 使用来自以下位置的 .aider.conf.yml 文件中的配置：

   • 您的主目录
   • git 仓库根目录
   • 当前目录
   • 使用 --config-file 指定的自定义路径

2. 使用来自以下位置的 .env 文件中的环境变量：

   • 您的主目录
   • git 仓库根目录
   • 当前目录
   • 使用 --env-file 指定的自定义路径

3. 在通过 MCP 工具编辑文件时传递自定义 Aider 选项。

Claude 的示例提示

连接到 Claude 后，您可以使用如下提示：

• "编辑我的 app.py 文件，为 main 函数添加错误处理"
• "创建一个名为 utils.py 的新文件，其中包含用于日期格式化的辅助函数"
• "显示我仓库的当前 git 状态"
• "从这段解释中提取 Python 代码并将其保存到一个文件中"

可用工具

MCP 服务器提供以下基于目录的工具：

• edit_files: 在指定目录中进行有针对性的代码更改

  • 需要目录路径和详细说明
  • 自动接受所有建议的更改（使用 --yes-always）
  • 可以根据需要指定其他 Aider 选项

• create_files: 在指定目录中创建包含内容的新文件

  • 您可以一次提供多个要创建的文件
  • 可选择将新文件提交到 git

• git_status: 获取指定目录仓库的 git 状态

  • 快速检查已修改、已添加、已删除和未跟踪的文件

• extract_code: 从 markdown 或文本中提取代码块

  • 可以选择将提取的代码块保存到指定目录中的文件中
  • 保留来自代码块标记的语言信息

• aider_status: 检查 Aider 安装和环境状态

  • 验证 Aider 是否已正确安装且可访问
  • 可以检查特定目录的配置
  • 报告 API 密钥和环境变量

• aider_config: 获取详细的 Aider 配置信息

  • 显示正在使用的配置文件
  • 显示来自所有配置层的设置
  • 报告可用的环境变量

环境变量

服务器使用环境变量，这些变量可以直接设置或通过 .env 文件设置：

• AIDER_PATH: Aider 可执行文件的路径
• REPO_PATH: git 仓库的路径
• AIDER_CONFIG_FILE: 自定义 Aider 配置文件的路径
• AIDER_ENV_FILE: 自定义 .env 文件的路径
• AIDER_MCP_VERBOSE: 启用详细日志记录
• OPENAI_API_KEY: 您的 OpenAI API 密钥（如果使用 GPT-4 与 Aider）
• ANTHROPIC_API_KEY: 您的 Anthropic API 密钥（如果使用 Claude 与 Aider）

调试

您可以使用 MCP 检查器来调试服务器：

# 使用 MCP 检查器进行测试
npx @modelcontextprotocol/inspector uvx aider-mcp

# 使用特定仓库路径进行测试
npx @modelcontextprotocol/inspector uvx aider-mcp --repo-path=/path/to/your/repo

# 如果从 Python 包运行
npx @modelcontextprotocol/inspector python -m aider_mcp

检查器提供了一个交互式 UI 来：

1. 查看可用工具及其模式
2. 使用测试参数调用工具
3. 查看响应并调试问题

开发

对于本地开发：

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

许可证

Unlicense