aider-mcp-server-rjn

🚀 Aider MCP 服务器

Aider MCP 服务器作为一座桥梁，连接 AI 助手（如 ChatGPT）与 Aider，用于执行代码相关任务。它借助 Model Context Protocol (MCP) 提供多种工具，助力 AI 更高效地开展代码分析、提取和操作工作。

🚀 快速开始

Aider MCP 服务器能让 AI 助手与 Aider 协同工作，实现高效的代码操作。以下是启动服务器前的准备工作和安装方法。

✨ 主要特性

• 代码编辑：可在 Git 仓库中编辑文件。
• 新文件创建：能根据需求生成新文件。
• 代码提取：可以从文本或 Markdown 中提取代码块。
• 状态检查：能够验证 Aider 是否正常运行及其配置情况。

📦 安装指南

使用 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

💻 使用示例

基本用法

运行服务器时，会自动加载所有工具并监听请求。

# 运行服务器
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）。

示例提示

代码提取

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

状态检查

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

📚 详细文档

先决条件

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

环境变量

| 属性 | 详情 | |------|------| | 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

开发指南

本地开发

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

运行服务器

python -m aider_mcp

🔚 结语

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