mcp-aider-executor

プロジェクト情報

aider をデタッチされたバックグラウンドプロセスとして実行し、基本的な git ツールとステータス確認機能を備えた stdio MCP サーバーです。これにより、LLM はコード編集プロセスを自由に開始し、後から aider のチャット履歴で進捗を確認して、エージェントのスウォーム的な動作を実現できます。

プロセス ID と開始日時を記録した .aider.mcp.details.json ファイルが同じディレクトリに作成されます。 MCP サーバーは、プロセスがまだ実行中かどうかを確認したり、更新を確認するために .aider.chat.history.md を確認したりするツールを LLM エージェントに提供します。

MCP サーバー経由で aider に送信された元のプロンプトメッセージも .aider.mcp.prompt.txt に記録されます。

クイックスタート

エンドポイント URL と API キーの環境変数を渡して、npx を使ってサーバーを直接実行できます。 許可する glob パスを指定した --whitelist 引数を渡してください。指定しない場合、すべての操作がデフォルトで拒否されます。

{
  "mcpServers": {
    "mcp-aider-executor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-aider-executor",
        "--whitelist",
        "/home/user/my-project/**",
        "--whitelist",
        "/local/my-application/**"
      ],
      "env": {
        "AIDER_MODEL": "openai/gemma-4-E4B-it-IQ4_XS",
        "OPENAI_API_BASE": "http://127.0.0.1:1337/v1",
        "OPENAI_API_KEY": "your-key-here"
      }
    }
  }
}

プロンプト

作業対象のディレクトリを指定して、LLM に Aider を使うよう直接指示できます。例：

Use Aider to create a simple Python hello world console application in "/home/my-project"

Aider の追加オプションを設定するには、環境変数（MCP 設定 .json の env）を使って適切に設定するか、プロジェクトディレクトリに Aider の YAML 設定ファイルを作成するよう LLM に依頼してください。デフォルトでは、サーバーには LLM が内容を確認できるよう、基本的な git およびファイルツールが備わっています。より高度な機能を別の MCP サーバーで処理する場合は、以下のオプションでこれらのツールを無効にできます。

注意

セキュリティ上の理由から、MCP サーバーには API キーを設定 YAML に書き込む機能がありません。 OPENAI_API_KEY などのキーを指定するには、代わりに env を使用してください。LLM にはこのことを伝えないでください。

オプション

npx コマンドに以下の引数を追加できます。

-h, --help                     Display this message
--model <model>                Default LLM main model override (i.e. always use this model no matter what)
--edit-format <format>         Main model edit format override, regardless of config or LLM inference
--architect                    Always run in architect mode (--no-architect for never)
--editor-model <model>         Default secondary editor model override for architect mode
--editor-edit-format <format>  Editor model's edit format override
--no-add-message-notes         Disables the adding of aider-specific notes to message prompts
--no-register-git-tools        Disables registration of all git tools for this server
--no-allow-git-edits           Disables only the git tools which modify the repo history
--no-register-file-tools       Disables registration of wide file access tools for this server
--whitelist <path>             Only allow operations within the glob path

環境の前提条件

MCP サーバーを実行する環境には、以下のツールがインストールされ、シェルから実行可能なコマンドとして利用できる必要があります。

1. node
2. aider
3. git

警告

aider に同じローカルエンドポイントを使用する場合は、並列リクエスト数を 2 に設定してください。そうしないと、チャットセッションとバックグラウンドの aider プロセスが互いの処理を待ち続けて停止します。

ローカルの OpenAI 互換エンドポイントを使用する場合、API キーを使わなくても aider が必要とするため、OPENAI_API_KEY 環境変数に空でない値を設定してください。

aider でローカルエンドポイントのモデル名を指定する場合も、openai/ プレフィックスが必要です。

利用可能な MCP ツール

LLM が呼び出せる MCP ツールの一覧です。

• aider_check_git_log：最近のコミットを確認します。
• aider_check_git_status：git status --short を呼び出して、指定したディレクトリの状態を確認します。
• aider_check_last_prompt：最後に実行した Aider の元のプロンプトメッセージを返します。
• aider_check_progress：Aider のチャット履歴とバックグラウンドプロセスの状態を確認します。
• aider_checkout_git_branch：git ブランチを切り替えます。存在しない場合は新しいブランチを作成します。
• aider_create_git_stash：ディレクトリを Aider が使えるように、すべてを退避します（git stash -u）。
• aider_git_revert：ハッシュで指定した git コミットの変更を元に戻します。
• aider_list_files：指定したディレクトリ内のすべてのファイルを一覧表示します。
• aider_list_git_branches：指定したディレクトリの git ブランチ一覧を返します。
• aider_mcp_check_whitelist：この Aider MCP サーバーで許可リストに登録されている glob パスを確認します。
• aider_message_prompt：指定したプロンプトメッセージで、バックグラウンドプロセスとして aider を起動します。
• aider_read_config_yaml：ディレクトリ内の .aider.conf.yml の内容全体を返します。
• aider_read_file_contents：指定したファイルパスの内容を読み取ります。
• aider_setup_config_yaml：ディレクトリ内に .aider.conf.yml ファイルを作成します。