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：

# 如果没有安装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. 点击添加新MCP服务器
4. 输入以下配置：

   名称: aider-mcp
   类型: 命令
   命令: uvx aider-m
   --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文件，在主函数中添加错误处理"
• "创建一个名为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 .

许可证

无许可证