Aider MCP 服务器

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

概述

这个 MCP 服务器在像 Claude 这样的 AI 助手和 Aider 强大的文件编辑能力之间架起了桥梁。它通过模型上下文协议提供了一个标准化的接口，允许 Claude：

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

前提条件

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

安装

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

使用 UV（推荐）

如果你已经安装了 uv：

# Install uv if you don't have it
curl -fsSL https://astral.sh/uv/install.sh | bash

# Run directly with uvx (no installation required)
uvx aider-mcp

使用 PIP

# Install the package
pip install aider-mcp

# Run the server
aider-mcp

使用

默认情况下，Aider MCP 服务器以 MCP 协议模式运行于标准输入输出上，这被设计为直接与像 Claude Desktop 和 Cursor IDE 这样的 MCP 客户端集成。

# Run directly with uvx (recommended)
uvx aider-mcp

# With repository path specified
uvx aider-mcp --repo-path=/path/to/your/repo

# With custom Aider executable path
uvx aider-mcp --aider-path=/path/to/aider

# With environment variables
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 检查器来调试服务器：

# Test with MCP inspector
npx @modelcontextprotocol/inspector uvx aider-mcp

# Test with specific repository path
npx @modelcontextprotocol/inspector uvx aider-mcp --repo-path=/path/to/your/repo

# If running from Python package
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 .

许可证

无许可证