Aider MCP Server Rjn

🚀 Aider MCP 服務器

Aider MCP 服務器是連接 AI 助手（如 ChatGPT）與 Aider 的橋樑，可執行代碼相關任務。它藉助 Model Context Protocol (MCP) 提供多種工具，助力 AI 更高效地開展代碼分析、提取和操作工作。

🚀 快速開始

在使用 Aider MCP 服務器前，需滿足以下先決條件：

1. Python 版本：確保安裝了 Python 3.6 或更高版本。
2. Aider 安裝：需在系統中安裝 Aider 並配置好環境變量。
3. API 密鑰：根據使用的 AI 提供商（OpenAI 或 Anthropic），需設置對應的 API 密鑰。
4. Git 倉庫：服務器需要訪問 Git 代碼倉庫以執行任務。

✨ 主要特性

• 功能豐富：提供代碼編輯、新文件創建、代碼提取、狀態檢查等多種工具。
• 配置靈活：支持通過參數選項、配置文件和環境變量進行靈活配置。
• 多客戶端支持：支持 Claude Desktop、Cursor IDE 等客戶端。

📦 安裝指南

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

可用工具

1. 代碼編輯：在 Git 倉庫中編輯文件。
2. 新文件創建：根據需求生成新文件。
3. 代碼提取：從文本或 Markdown 中提取代碼塊。
4. 狀態檢查：驗證 Aider 是否正常運行及其配置。

環境變量

調試

使用 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 助手和 Aider 進行交互，實現代碼相關任務的執行。它利用 Python 語言開發，藉助 Git 倉庫進行代碼管理。

📄 許可證

文檔未提及許可證相關信息。