Aider MCP Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Supports reading environment variables from .env files in various locations to configure the Aider MCP server.

  • Provides tools for checking git repository status, creating files and committing them to git, and working within git repositories.

  • Enables extraction of code blocks from markdown text, preserving language information from code block markers.

Aider MCP サーバー

Claude や他の MCP クライアントがAiderに接続して効率的なファイル編集機能を使用できるようにするモデル コンテキスト プロトコル (MCP) サーバー。

概要

このMCPサーバーは、ClaudeのようなAIアシスタントとAiderの強力なファイル編集機能との間のギャップを埋めます。モデルコンテキストプロトコル(MCP)を介した標準化されたインターフェースを提供することで、Claudeは以下のことが可能になります。

  • Aiderの機能を使用して既存のファイルを編集する
  • コンテンツを含む新しいファイルを作成する
  • マークダウンテキストからコードブロックを抽出する
  • Gitのステータス情報を取得する
  • Aiderの設置状況を確認する
  • Aiderの設定システムにアクセスして使用する

前提条件

  • Python 3.8以上
  • Aider がインストールされました ( pip install aider-chat )
  • OpenAI または Anthropic の API キー(Aider で使用するモデルによって異なります)
  • ファイル編集用のGitリポジトリ

インストール

Aider MCP サーバーはいくつかの方法でインストールできます。

UVの使用(推奨)

uvがインストールされている場合:

# 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 : カスタム Aider 設定ファイルへのパス
  • --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. 設定後、MCPツールを使用するには、Composerでエージェントモードになっていることを確認してください。

Aider構成サポート

この MCP サーバーは Aider の構成システムをサポートしており、次のことが可能になります。

  1. 次の.aider.conf.ymlファイルからの設定を使用します。
    • ホームディレクトリ
    • Gitリポジトリのルート
    • 現在のディレクトリ
    • --config-fileで指定されたカスタムパス
  2. 次の.envファイルから環境変数を使用します。
    • ホームディレクトリ
    • Gitリポジトリのルート
    • 現在のディレクトリ
    • --env-fileで指定されたカスタムパス
  3. MCP ツールを使用してファイルを編集するときに、カスタム Aider オプションを渡します。

クロードの例題

Claude に接続すると、次のようなプロンプトを使用できます。

  • 「app.py ファイルを編集して、メイン関数にエラー処理を追加します」
  • 「日付フォーマットのヘルパー関数を含む utils.py という新しいファイルを作成します」
  • 「リポジトリの現在のgitステータスを表示してください」
  • 「この説明からPythonコードを抽出し、ファイルに保存します」

利用可能なツール

MCP サーバーは、次のディレクトリベースのツールを提供します。

  • edit_files : 指定したディレクトリ内の対象コードを変更する
    • ディレクトリパスと詳細な手順が必要です
    • 提案されたすべての変更を自動的に受け入れます( --yes-alwaysを使用)
    • 必要に応じて追加のAiderオプションを指定できます
  • create_files : 指定されたディレクトリにコンテンツを含む新しいファイルを作成する
    • 複数のファイルを一度に作成できます
    • オプションで新しいファイルをgitにコミットします
  • git_status : 指定されたディレクトリのリポジトリのgitステータスを取得する
    • 変更、追加、削除、追跡されていないファイルをすばやく確認する方法
  • extract_code : マークダウンまたはテキストからコードブロックを抽出します
    • オプションで抽出したコードブロックを指定したディレクトリ内のファイルに保存できます
    • コードブロックマーカーから言語情報を保持します
  • aider_status : Aider のインストールと環境のステータスを確認します
    • Aiderが正しくインストールされ、アクセス可能であることを確認します
    • 特定のディレクトリの設定をチェックできる
    • APIキーと環境変数に関するレポート
  • aider_config : 詳細な Aider 構成情報を取得します
    • 使用されている設定ファイルを表示します
    • すべての構成層の設定を表示します
    • 利用可能な環境変数を報告します

環境変数

サーバーは、直接または.envファイルを通じて設定できる環境変数を使用します。

  • AIDER_PATH : Aider実行ファイルへのパス
  • REPO_PATH : Gitリポジトリへのパス
  • AIDER_CONFIG_FILE : カスタム Aider 設定ファイルへのパス
  • AIDER_ENV_FILE : カスタム.envファイルへのパス
  • AIDER_MCP_VERBOSE : 詳細ログを有効にする
  • OPENAI_API_KEY : OpenAI API キー(Aider で GPT-4 を使用する場合)
  • ANTHROPIC_API_KEY : Anthropic API キー (Claude を Aider と併用する場合)

デバッグ

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 .

ライセンス

ライセンス解除

-
security - not tested
A
license - permissive license
-
quality - not tested

Claude やその他の MCP クライアントを Aider に接続するモデル コンテキスト プロトコル サーバー。AI アシスタントが効率的にファイルを編集し、新しいファイルを作成し、自然言語を通じて Git リポジトリと対話できるようになります。

  1. Overview
    1. Prerequisites
      1. Installation
        1. Using UV (Recommended)
        2. Using PIP
      2. Usage
        1. Command Line Options
      3. Client Configuration
        1. Claude Desktop
        2. Cursor IDE
      4. Aider Configuration Support
        1. Example Prompts for Claude
          1. Available Tools
            1. Environment Variables
              1. Debugging
                1. Development
                  1. License
                    ID: 8fd63v5mwh