🚀 Aider MCP 服务器

本项目是一个使用 Aider 提供 AI 编程能力的机器认知协议 (MCP) 服务器，借助标准化 API 为用户提供编程能力，能有效降低成本并利用 Aider 的强大功能。

🚀 快速开始

此 MCP 服务器利用 Aider 这一强大的 AI 编程助手，通过标准化 API 提供编程能力。通过将工作巧妙地转移到 Aider，我们可以降低成本，同时利用其功能。

✨ 主要特性

• AI 代码生成：自动生成高质量的代码。
• 模型选择：可根据需求选择合适的模型。
• 灵活配置：支持自定义设置以满足不同场景的需求。

📦 安装指南

先决条件

• Python 版本：需要 Python 3.10 或更高版本。
• API 密钥：配置所需的 API 访问密钥。

安装命令

# 示例安装命令
pip install aider-mcp-server

💻 使用示例

配置

使用环境变量进行配置：

运行服务器

使用命令行运行

# 示例运行命令
python -m aider_mcp_server --port 8050

自定义配置文件

创建一个配置文件 config.json：

{
  "port": 8050,
  "models": {
    "default": "gemini/gemini-2.5-pro-preview-03-25"
  }
}

MCP 工具

AI 编程工具

功能

• 代码生成：自动生成代码片段。
• 模型选择：支持多种编程模型。

示例配置

{
  "ai_coding_prompt": "实现一个计算阶乘的函数",
  "relative_editable_files": ["math.py"],
  "settings": {
    "auto_commits": false,
    "use_git": false
  }
}

模型管理工具

功能

• 模型列表：列出所有可用模型。
• 过滤功能：根据子字符串过滤模型。

与 MCP 客户端集成

使用 Docker 集成

{
    "mcpServers": {
      "aider-mcp-server": {
        "command": "docker",
        "args": [ "run", "-i", "--rm",
          "--mount", "type=bind,source=<YOUR_FULL_PATH>",
          "-e", "TRANSPORT=stdio",
          "-e", "EDITOR_MODEL=gemini/gemini-2.5-pro-preview-03-25",
          "-e", "GEMINI_API_KEY=<YOUR_API_KEY>",
          "danielscholl/aider-mcp-server"
        ]
      }
    }
  }

使用命令行工具

# 示例运行命令
python -m aider_mcp_server --config config.json

📚 详细文档

故障排除

常见问题及解决方案：

1. 无法连接到服务器：检查服务器是否在正确的端口上运行。
2. 模型加载失败：确保 API 密钥正确且有效。

📄 许可证

项目遵循 MIT License。