Aider

🚀 MCP 服務器：Aider 的 AI 幫助程序

aider-mcp-server 是一個專為實現與 Claude 等先進 AI 模型交互而設計的 MCP（Modular Conversation Protocol）服務器。此項目通過標準化接口，簡化了集成和擴展過程，為開發者提供了便捷的使用體驗。

🚀 快速開始

安裝依賴

pip install aider-mcp-server

啟動服務器

aider-mcp-server --editor-model openai/gpt-4o

示例請求

請求示例

{
  "name": "aider_ai_code",
  "parameters": {
    "substring": "gemini"
  }
}

返回結果

{
  "success": true,
  "diff": "+ This is a test diff line.\n- This is another test diff line."
}

✨ 主要特性

• 模塊化架構：遵循 "MCP 協議" 設計原則，組件間松耦合，便於維護和升級。
• 高性能通信：支持高併發連接，確保在多用戶環境下穩定運行。
• 靈活適配性：藉助插件式設計，支持多種 AI 服務提供商（如 Claude、GPT - 4）的集成。

📚 詳細文檔

核心組件

服務器層

處理 MCP 協議的通信，接收和發送請求/響應。

原子層（Atoms）

功能純淨、可複用的組件：

工具

• aider_ai_code：提供 AI 編程輔助功能。
• list_models：列出支持的 AI 模型。

輔助函數

• utils.py：包含常量和一些實用工具，例如默認模型名稱。
• data_types.py：定義 Pydantic 數據結構，確保數據驗證。
• logging.py：配置統一的日誌記錄格式，適用於控制檯和文件輸出。

服務器邏輯

• server.py：初始化 MCP 服務器，註冊原子層工具，處理入站請求，並根據 MCP 協議路由到相應的工具邏輯，發送響應。

插件系統

允許添加自定義功能模塊，增強服務器擴展性。

🔧 技術細節

架構原理

• 設計哲學：遵循 "單一職責" 原則，每個組件專注於特定任務。
• 通信機制：使用 WebSocket 或 HTTP 協議進行即時交互。
• 數據處理：通過 Pydantic 進行數據驗證和反序列化。

代碼結構

.
├── ai_docs                   # AI 相關文檔
│   ├── just-prompt-example-mcp-server.xml
│   └── programmable-aider-documentation.md
├── pyproject.toml            # 項目元數據與依賴管理
├── README.md                 # 項目說明文件
├── specs                     # 規範性文件
│   └── init-aider-mcp-exp.md
├── src                       # 源代碼目錄
│   └── aider_mcp_server      # 主要服務器包
│       ├── __init__.py       # 包初始化
│       ├── __main__.py       # 服務器啟動入口點
│       ├── atoms             # 核心、可複用組件（純函數）
│       │   ├── __init__.py
│       │   ├── data_types.py # Pydantic 數據結構定義
│       │   ├── logging.py    # 自定義日誌配置
│       │   ├── tools         # 各個工具的具體實現
│       │   │   ├── __init__.py
│       │   │   ├── aider_ai_code.py # AI 編程輔助工具邏輯
│       │   │   └── aider_list_models.py # 列出模型工具邏輯
│       │   └── utils.py      # 共用函數與常量（如默認模型）
│       ├── server.py         # MCP 服務器邏輯，工具註冊、請求處理
│       └── tests             # 單元測試與集成測試
│           ├── __init__.py
│           └── atoms         # 測試原子層組件
│               ├── __init__.py
│               ├── test_logging.py # 測試日誌功能
│               └── tools     # 測試工具邏輯
│                   ├── __init__.py
│                   ├── test_aider_ai_code.py # AI 編程輔助工具測試
│                   └── test_aider_list_models.py # 列出模型工具測試

• src/aider_mcp_server：包含服務器的核心邏輯和配置。
• __main__.py：作為應用入口，負責解析命令行參數並啟動服務器。

使用說明

配置選項

--editor-model <model_name>    # 指定使用的編輯器模型，默認為 Claude - 2
--listen <host>                # 設置監聽地址，默認為 localhost
--port <number>                # 設置監聽端口，默認為 8080

示例使用

aider-mcp-server --editor-model openai/gpt-4o --listen 127.0.0.1 --port 8090

開發指南

貢獻代碼

1. 克隆倉庫

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

2. 創建功能分支

git checkout -b feature/new-feature

3. 提交代碼

git add .
git commit -m "添加新功能"
git push origin feature/new-feature

4. 發起拉取請求 通過 GitHub 提交 Pull Request，確保代碼符合項目規範。

問題反饋

如遇任何問題或有改進建議，請訪問 GitHub 倉庫 提交 Issues。

📄 許可證

本項目遵循 MIT 協議開源，詳細許可信息請見 LICENSE 文件。