AI导哈

文件编辑MCP服务器

Aider MCP服务器是一个基于模型上下文协议（MCP）的服务，为Claude等AI助手提供文件编辑功能，包括编辑现有文件、创建新文件、提取代码块、获取git状态等。

  • by sengokudaikon
  • Python
  • 本地部署
  • 40 星标
  • 更新于
在 GitHub 查看 sengokudaikon/aider-mcp-server

使用说明

MCP服务器助手

一个模型上下文协议（MCP）服务器，允许Claude和其他MCP客户端连接到 帮助 以实现高效的文件编辑功能。

概述

这个MCP服务器弥合了Claude和Aider等AI助手强大的文件编辑功能之间的差距。它通过模型上下文协议提供了一个标准化的接口，允许Claude：

  • 使用Aider的功能编辑现有文件
  • 创建包含内容的新文件
  • 从markdown文本中提取代码块
  • 获取git状态信息
  • 检查帮助安装状态
  • 访问和使用Aider的配置系统

先决条件

  • Python 3.8或更高版本
  • 帮助安装（pip install aider-chat)
  • OpenAI或Anthropic的API密钥（取决于您希望Aider使用的模型）
  • 用于文件编辑的Git存储库

安装

您可以通过多种方式安装Aider MCP服务器：

使用紫外线（推荐）

如果你有 紫外线 安装：

# Install uv if you don't have it
curl -fsSL https://astral.sh/uv/install.sh | bash

# Run directly with uvx (no installation required)
uvx aider-mcp

使用PIP

# Install the package
pip install aider-mcp

# Run the server
aider-mcp

用法

Aider MCP服务器默认在stdio上以MCP协议模式运行，该模式专为与Claude Desktop和Cursor IDE等MCP客户端直接集成而设计。

# Run directly with uvx (recommended)
uvx aider-mcp

# With repository path specified
uvx aider-mcp --repo-path=/path/to/your/repo

# With custom Aider executable path
uvx aider-mcp --aider-path=/path/to/aider

# With environment variables
REPO_PATH=/path/to/your/repo uvx aider-mcp

命令行选项

您可以使用以下环境变量或命令行参数自定义服务器：

  • --aider-path：Aider可执行文件的路径（默认：“Aider”，自动搜索Path）
  • --repo-path：git存储库的路径（默认：当前目录）
  • --config-file：自定义助手配置文件的路径
  • --env-file：自定义.env文件的路径
  • --verbose, -v：启用详细输出

客户端配置

克劳德桌面

将此添加到您的Claude Desktop配置文件中：

{
  "mcpServers": {
    "aider-mcp": {
      "command": "uvx",
      "args": [
        "aider-mcp",
        "--repo-path", "/path/to/your/repo"
      ]
    }
  }
}

光标IDE

要与Cursor IDE集成，请执行以下操作：

  1. 打开光标设置
  2. 引导到 Features > MCP Servers
  3. 点击 Add new MCP server
  4. 输入此配置：
    name: aider-mcp
type: command
command: uvx aider-mcp --repo-path=/path/to/your/repo
  5. 配置后，确保您在Composer中处于代理模式以使用MCP工具

帮助配置支持

此MCP服务器支持Aider的配置系统，允许您：

  1. 使用来自的配置 .aider.conf.yml 文件位于：

    • 您的主目录
    • git存储库根目录
    • 当前目录
    • 使用指定的自定义路径 --config-file

  2. 使用以下环境变量 .env 文件位于：

    • 您的主目录
    • git存储库根目录
    • 当前目录
    • 使用指定的自定义路径 --env-file

  3. 通过MCP工具编辑文件时传递自定义助手选项。

克劳德提示示例

连接到Claude后，您可以使用以下提示：

  • “编辑我的app.py文件，将错误处理添加到主函数中”
  • “创建一个名为utils.py的新文件，其中包含用于日期格式化的辅助函数”
  • “显示存储库的当前git状态”
  • “从本说明中提取Python代码并将其保存到文件中”

可用工具

MCP服务器提供以下基于目录的工具：

  • edit_files：在指定目录中进行有针对性的代码更改

    • 需要目录路径和详细说明
    • 自动接受所有建议的更改（使用 --yes-always)
    • 需要时可以指定其他助手选项

  • create_files：使用指定目录中的内容创建新文件

    • 您可以同时提供多个文件进行创建
    • 可选地将新文件提交到git

  • git_status：获取指定目录存储库的git状态

    • 快速检查修改、添加、删除和未跟踪文件的方法

  • extract_code：从markdown或文本中提取代码块

    • 可以选择将提取的代码块保存到指定目录中的文件中
    • 保留代码块标记中的语言信息

  • aider_status：检查辅助器安装和环境状态

    • 验证助手是否正确安装且可访问
    • 可以检查特定目录的配置
    • 关于API密钥和环境变量的报告

  • aider_config：获取详细的Aider配置信息

    • 显示正在使用的配置文件
    • 显示所有配置层的设置
    • 报告可用的环境变量

环境变量

服务器使用可以直接或通过以下方式设置的环境变量 .env 文件夹：

  • AIDER_PATH：Aider可执行文件的路径
  • REPO_PATH：git存储库的路径
  • AIDER_CONFIG_FILE：自定义助手配置文件的路径
  • AIDER_ENV_FILE：自定义.env文件的路径
  • AIDER_MCP_VERBOSE：启用详细日志记录
  • OPENAI_API_KEY：您的OpenAI API密钥（如果与Aider一起使用GPT-4）
  • ANTHROPIC_API_KEY：您的Anthropic API密钥（如果与助手一起使用Claude）

调试

您可以使用MCP检查器调试服务器：

# Test with MCP inspector
npx @modelcontextprotocol/inspector uvx aider-mcp

# Test with specific repository path
npx @modelcontextprotocol/inspector uvx aider-mcp --repo-path=/path/to/your/repo

# If running from Python package
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 .

许可证

无许可证

相关 MCP