Aider

🚀 AiderのAIヘルパー：MCPサーバ

aider - mcp - server は、Claudeなどの先進的なAIモデルとの対話を実現するために設計されたMCP（Modular Conversation Protocol）サーバです。このプロジェクトは、標準化されたインターフェースを通じて、統合と拡張のプロセスを簡素化することを目的としています。

✨ 主な機能

• モジュール化アーキテクチャ：「MCPプロトコル」の設計原則に従っており、コンポーネント間の結合度が低く、保守とアップグレードが容易です。
• 高パフォーマンス通信：高い同時接続数をサポートし、多ユーザ環境での安定した動作を保証します。
• 柔軟な適応性：プラグイン式の設計により、ClaudeやGPT - 4などの複数のAIサービスプロバイダの統合をサポートしています。

🚀 クイックスタート

📦 インストール

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プロトコルの通信を処理し、リクエストとレスポンスの送受信を行います。

アトム層（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 ファイルを参照してください。