Aider MCP Server

🚀 Aider MCP サーバー

このサーバーは、Model Context Protocol (MCP) を使用して、Claude やその他の MCP クライアントを Aider に接続し、効率的なファイル編集機能を提供します。

🚀 クイックスタート

この MCP サーバーは、Claude などの AI アシスタントと Aider の強力なファイル編集機能をつなぐ役割を果たします。Model Context Protocol を通じて、Claude は以下のことができます。

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

✨ 主な機能

• AI アシスタントと Aider のファイル編集機能を接続する
• 様々なファイル操作やコード操作を提供する
• 環境変数や設定ファイルを使った柔軟な設定が可能

📦 インストール

方法1：pip を使って最新の安定版をインストール

pip install aider-mcp

方法2：ソースコードからインストール

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

💻 使用例

サーバーを起動する

uvx aider-mcp --port 3000

コマンドラインから実行する

python -m aider_mcp --repo-path /path/to/repo

環境変数を設定する

• REPO_PATH を設定してリポジトリのパスを指定する：

  export REPO_PATH=/path/to/repo
  

• AIDER_MCP_VERBOSE を設定してデバッグログを有効にする：

  export AIDER_MCP_VERBOSE=true
  

設定ファイルを使って設定する

~/.config/aider-mcp/config.json ファイルを作成または編集し、以下の内容を追加する：

{
  "repoPath": "/path/to/repo",
  "aiderPath": "/path/to/aider",
  "verbose": true
}

📚 ドキュメント

利用可能なツール

1. ファイル管理

   • file-manager/list-files：指定されたディレクトリ内のすべてのファイルをリストする。
   • file-manager/read-file：特定のファイルの内容を読み取る。
   • file-manager/write-file：指定されたファイルに内容を書き込む。

2. バージョン管理

   • git-status：git リポジトリの状態情報を取得する（未追跡、変更済み、削除済みのファイルを含む）。
   • git-commit：指定された変更をコミットする。
   • git-push：コードをリモートリポジトリにプッシュする。

3. コード操作

   • code-analyzer/highlight-code：コードスニペットに構文ハイライトを適用する。
   • code-generator/generate-function：説明に基づいて関数コードを生成する。
   • code-formatter/format-file：指定されたファイルのコードを整形する。

環境変数

基本設定

• REPO_PATH：デフォルトのリポジトリパスを指定する（デフォルトは現在のディレクトリ）。
• AIDER_MCP_VERBOSE：詳細なログ出力を有効にする（true または false）。

高度な設定

• EDITOR：デフォルトのエディターを設定する（vim や VSCode など）。
• BRANCH_NAME：デフォルトのブランチ名を指定する（通常は main または master）。
• COMMIT_MESSAGE：デフォルトのコミットメッセージテンプレートを指定する（変数置換をサポート）。

デバッグ

MCP モニターを使ってデバッグする

npx @modelcontextprotocol/inspector uvx aider-mcp

リポジトリパスを指定してモニターを起動する

npx @modelcontextprotocol/inspector --repo-path=/path/to/repo

開発

ローカル開発の手順

1. コードリポジトリをクローンする：

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

2. 依存関係をインストールし、開発サーバーを起動する：

   pip install -e .
   python -m aider_mcp --dev
   

📄 ライセンス

このプロジェクトは Unlicense ライセンスの下で公開されており、ソースコードとドキュメントは自由に使用、変更、配布することができます。