Aider MCP Server

🚀 Aider MCP 服務器

Aider MCP 服務器是一個模型上下文協議（MCP）服務器，它允許 Claude 和其他 MCP 客戶端連接到 Aider，從而實現高效的文件編輯能力。

🚀 快速開始

此 MCP 服務器彌合了 AI 助手（如 Claude）與 Aider 強大的文件編輯功能之間的差距。它通過 Model Context Protocol 提供了一個標準化接口，讓 Claude 能使用 Aider 的能力編輯現有文件、創建新文件、提取代碼塊、獲取 git 狀態信息、檢查 Aider 安裝狀態以及訪問並使用 Aider 的配置系統。

✨ 主要特性

• 使用 Aider 的能力編輯現有文件
• 創建包含內容的新文件
• 從 Markdown 文本中提取代碼塊
• 獲取 git 狀態信息
• 檢查 Aider 安裝狀態
• 訪問並使用 Aider 的配置系統

📦 安裝指南

先決條件

• Python 3.8 或更高版本
• 已安裝 Aider（pip install aider-chat）
• OpenAI 或 Anthropic 的 API 密鑰（具體取決於使用的模型）
• Git 環境變量已配置（用於倉庫路徑）

安裝方式

方式一：使用 pip 安裝最新穩定版本

pip install aider-mcp

方式二：從源碼安裝

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

💻 使用示例

啟動服務器

uvx aider-mcp --port 3000

通過命令行運行

python -m aider_mcp --repo-path /path/to/repo

📚 詳細文檔

配置示例

在環境中設置變量

• 設置 REPO_PATH 指定倉庫路徑：

  export REPO_PATH=/path/to/repo
  

• 設置 AIDER_MCP_VERBOSE 啟用調試日誌：

  export AIDER_MCP_VERBOSE=true
  

在配置文件中設置

創建或編輯 ~/.config/aider-mcp/config.json 文件，添加以下內容：

{
  "repoPath": "/path/to/repo",
  "aiderPath": "/path/to/aider",
  "verbose": true
}

工具介紹

可用工具

1. 文件管理

   • file-manager/list-files：列出指定目錄下的所有文件。
   • file-manager/read-file：讀取特定文件的內容。
   • file-manager/write-file：將內容寫入指定文件。

2. 版本控制

   • git-status：獲取 git 倉庫的狀態信息，包括未跟蹤、已修改和已刪除的文件。
   • git-commit：對指定變更進行提交。
   • git-push：將代碼推送到遠程倉庫。

3. 代碼操作

   • code-analyzer/highlight-code：對代碼片段進行語法高亮。
   • code-generator/generate-function：根據描述生成函數代碼。
   • code-formatter/format-file：格式化指定文件的代碼。

環境變量

基本設置

• REPO_PATH：指定默認倉庫路徑，默認為當前目錄。
• AIDER_MCP_VERBOSE：啟用詳細日誌輸出，可選值為 true 或 false。

高級配置

• EDITOR: 設置默認編輯器，如 vim 或 VSCode。
• BRANCH_NAME: 指定默認分支名稱，通常為 main 或 master。
• COMMIT_MESSAGE: 默認提交信息模板，支持變量替換。

調試

使用 MCP 監視器調試

npx @modelcontextprotocol/inspector uvx aider-mcp

指定倉庫路徑啟動監視器

npx @modelcontextprotocol/inspector --repo-path=/path/to/repo

開發

本地開發步驟

1. 克隆代碼庫：

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

2. 安裝依賴項並啟動開發服務器：

   pip install -e .
   python -m aider_mcp --dev
   

📄 許可證

本項目採用 Unlicense 協議，源代碼和文檔均可自由使用、修改和分發。