AI编程集成工具

AiderMCP是一个模型上下文协议服务器,将Aider AI配对编程功能集成到Claude Desktop和Claude Code中,通过自然语言对话实现代码编辑、功能添加、错误修复等功能。

  • by fuzemobi
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 fuzemobi/AiderMCP

使用说明

🤖 AiderMCP:为Claude桌面版及Claude代码版集成Aider AI

AiderMCP是一个 模型上下文协议(MCP)服务器 那个(或这个)集成了 帮助 将AI配对编程集成到Claude Desktop和Claude Code中。通过与Claude的自然语言对话,使用Aider强大的代码编辑功能。


✨ 特点

  • ⚡(闪电符号,常用于表示速度、能量或警告) 使用uvx实现零安装直接从GitHub运行 - 无需克隆或设置!
  • 🚀 表情符号“🚀”在中文中通常被直接保留为表情符号,不直接翻译成文字,但如果需要解释其含义,可以表述为“火箭”或“飞速前进”。在这个上下文中,由于没有具体的文字描述与之搭配,所以直接以表情符号呈现。 一键设置: aider-mcp-server --setup 用于手动安装
  • 🎯(靶心) 自然语言接口通过对话指令使用Aider
  • 🔧(扳手或修理工具的符号,根据上下文可具体翻译为“扳手”或“修理工具”等) 5大强力工具代码优化、功能增加、错误修复、重构和状态检查
  • 🌍 代表地球,常用于表达全球、世界等概念。 跨平台在 macOS、Windows 和 Linux 上均可运行
  • 🔐 多供应商支持Anthropic、OpenAI和Google Gemini API密钥

📋 前提条件


🚀 快速入门 uvx(推荐)

使用AiderMCP的最快方法 - 无需克隆或安装!

1. 添加到Claude桌面配置

编辑您的Claude桌面配置文件:

  • macOS(苹果电脑操作系统): ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

添加此配置:

{
  "mcpServers": {
    "aider": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/fuzemobi/AiderMCP.git",
        "aider-mcp-server"
      ],
      "env": {
        "GEMINI_API_KEY": "your-gemini-key-here",
        "ANTHROPIC_API_KEY": "your-anthropic-key-here",
        "OPENAI_API_KEY": "your-openai-key-here"
      }
    }
  }
}

注释:

  • 添加您的API密钥(至少一个:Gemini、Anthropic或OpenAI)
  • 如果您有其他MCP服务器,请将此合并到现有的服务器中 mcpServers 物体;目标;对象
  • 如果你已经克隆了这个仓库,请将URL更新为你自己的fork的地址

2. 重启Claude桌面版

就是这些!uvx 将自动:

  • 下载该存储库
  • 安装所有依赖项(aider-chat,fastmcp)
  • 启动MCP服务器

🔧 手动安装(另一种方法)

如果您更喜欢手动安装或需要修改代码:

1. 安装

# Clone the repository
git clone https://github.com/fuzemobi/AiderMCP.git
cd AiderMCP

# Create virtual environment (Python 3.11 or 3.12)
python3.12 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# Install
pip install -e .

2. 设置API密钥

# macOS/Linux
export GEMINI_API_KEY="your-key-here"
export ANTHROPIC_API_KEY="your-key-here"  # optional
export OPENAI_API_KEY="your-key-here"     # optional

# Windows PowerShell
$env:GEMINI_API_KEY="your-key-here"

3. 配置Claude桌面版

aider-mcp-server --setup

4. 重启Claude桌面版

重要提示: 重启 Claude 桌面版以使更改生效。


🎮 基本用法

在Claude Desktop或Claude Code中

使用自然语言与Aider协作:

提高代码质量:

Use aider to improve code quality in src/main.py

添加功能:

Ask aider to add user authentication with JWT tokens

修复漏洞:

Have aider fix the connection timeout bug in server.py

重构代码:

Get aider to refactor the database module for better performance

检查状态:

Use aider to show git status and recent commits

🛠️ 可用工具

工具 描述
改进代码 提高代码质量,添加类型提示,增强错误处理
添加功能 为您的应用程序添加新功能
修复漏洞 修复代码库中的错误和问题
重构 重构代码以提升结构和性能
获取状态 查看 git 状态和最近提交

工具参数

所有工具都支持这些可选参数:

  • 文件需要处理的特定文件
  • 模型要使用的AI模型(默认: gemini/gemini-1.5-pro-latest)
  • 自动提交自动提交更改(默认: True)
  • 项目路径项目目录路径(默认:当前目录)

🏗️ 关于Aider

帮助 是一个与你的代码协同工作的AI配对编程工具。它能够:

  • 同时编辑多个文件
  • 在你的整个代码库中进行协调一致的更改
  • 了解你的项目结构
  • 遵循编码规范和模式
  • 自动创建 Git 提交

AiderMCP 通过 Claude 的对话界面使 Aider 更易于使用,让您可以用自然语言描述所需内容。


🚨 故障排除

在Claude桌面版中未显示的工具?

  1. 运行安装程序后重启Claude Desktop
  2. 重新运行: aider-mcp-server --setup
  3. 检查配置文件是否存在:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

Python版本错误?

python3 --version  # Must be 3.11 or 3.12

# Recreate venv if needed:
rm -rf .venv
python3.12 -m venv .venv
source .venv/bin/activate
pip install -e .

API密钥有问题吗?

# Verify keys are set
echo $GEMINI_API_KEY

# Or add to config file manually after running setup

📄 许可证

MIT 许可证 - 请参阅 许可证 文件中有详细信息。


🙏 致谢


为希望在Claude中使用AI辅助编码的开发者们,用心打造