Aider MCP サーバー

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

概要

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

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

Related MCP server: Hass-MCP

前提条件

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 と統合するには:

カーソル設定を開く
Features > MCP Serversに移動します
Add new MCP serverクリックします

次の構成を入力します。

name: aider-mcp
type: command
command: uvx aider-mcp --repo-path=/path/to/your/repo

設定後、MCPツールを使用するには、Composerでエージェントモードになっていることを確認してください。

Aider構成サポート

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

次の.aider.conf.ymlファイルからの設定を使用します。
- ホームディレクトリ
- Gitリポジトリのルート
- 現在のディレクトリ
- --config-fileで指定されたカスタムパス
次の.envファイルから環境変数を使用します。
- ホームディレクトリ
- Gitリポジトリのルート
- 現在のディレクトリ
- --env-fileで指定されたカスタムパス
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 を提供します。

利用可能なツールとそのスキーマを表示する
テストパラメータを使用してツールを呼び出す
応答を確認し、問題をデバッグする

発達

地域開発の場合:

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

ライセンス

ライセンス解除

Aider MCP Server