Aider MCP 服务器

概述

Aider MCP 服务器是一个桥梁，连接 AI 助手（如 ChatGPT）与 Aider，以便执行代码相关任务。它通过 Model Context Protocol (MCP) 提供多种工具，帮助 AI 更高效地完成代码分析、提取和操作。

先决条件

1. Python 版本：确保安装了 Python 3.6 或更高版本。
2. Aider 安装：需在系统中安装 Aider 并配置好环境变量。
3. API 密钥：根据使用的 AI 提供商（OpenAI 或 Anthropic），需设置对应的 API 密钥。
4. Git 仓库：服务器需要访问 Git 代码仓库以执行任务。

安装方法

使用 uv

# 基本使用
uvx aider-mcp

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

# 环境变量配置
AIDER_PATH=/path/to/aider uvx aider-mcp

使用 pip

# 克隆仓库并安装
git clone https://github.com/yourusername/aider-mcp-server.git
cd aider-mcp-server
pip install -e .

# 运行服务器
python -m aider_mcp

使用说明

• 基本命令：运行服务器时，会自动加载所有工具并监听请求。
• 参数选项：

  --repo-path <path>   # 指定 Git 仓库路径，默认为当前目录
  --aider-path <path> # 指定 Aider 可执行文件路径
  --verbose           # 启用详细日志输出
  

客户端配置

Claude Desktop

在 config.json 中添加以下内容：

{
  "tools": [
    {
      "name": "aider-mcp",
      "description": "与 Aider 交互的桥梁工具",
      "path": "uvx aider-mcp --repo-path ${REPO_PATH}"
    }
  ]
}

Cursor IDE

通过命令行运行：

npx @modelcontextprotocol/core uvx aider-mcp --repo-path /path/to/your/repo

Aider 配置支持

• 配置文件：支持 --aider-config-file 参数指定自定义配置文件路径。
• 环境变量：支持通过 .env 文件或直接设置环境变量（如 AIDER_ENV_FILE）。

示例提示

1. 代码提取：

   # 提取 Markdown 中的代码块并保存到目标目录
   aider-mcp extract-code --source-file README.md --output-dir ./extracted_code
   

2. 状态检查：

   # 检查 Aider 状态和配置信息
   aider-mcp aider_status
   

可用工具

1. 代码编辑：在 Git 仓库中编辑文件。
2. 新文件创建：根据需求生成新文件。
3. 代码提取：从文本或 Markdown 中提取代码块。
4. 状态检查：验证 Aider 是否正常运行及其配置。

环境变量

• AIDER_PATH：指定 Aider 的安装路径。
• REPO_PATH：指定 Git 仓库的路径。
• AIDER_CONFIG_FILE：自定义配置文件路径。
• AIDER_ENV_FILE：自定义环境变量文件路径。
• OPENAI_API_KEY 和 ANTHROPIC_API_KEY：用于与 OpenAI 或 Anthropic 的 API 交互。

调试

使用 MCP 检查器进行调试：

# 基本测试
npx @modelcontextprotocol/inspector uvx aider-mcp

# 指定仓库路径
npx @modelcontextprotocol/inspector uvx aider-mcp --repo-path /path/to/your/repo

开发指南

1. 本地开发：

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

2. 运行服务器：

   python -m aider_mcp
   

结语

Aider MCP 服务器通过 MCP 协议，为 AI 助手提供了强大的代码操作能力。无论是代码分析、提取还是修改，它都能高效完成任务，极大提升开发效率。