Acp MCP Server

🚀 ACP-MCP-Server

「エージェント通信プロトコル (ACP)」のエージェントと「モデルコンテキストプロトコル (MCP)」のクライアントを接続するブリッジサーバーです。ACPベースのAIエージェントとClaude DesktopのようなMCP互換ツールをシームレスに統合します。

🚀 クイックスタート

インストール

# PyPIからインストール
pip install acp-mcp-server

# または、uvxを使用して隔離実行
uvx acp-mcp-server

基本的な使用法

# STDIOで実行（デフォルト、Claude Desktop用）
acp-mcp-server

# SSEトランスポートで実行
acp-mcp-server --transport sse --port 8000

# HTTPトランスポートで実行
acp-mcp-server --transport streamable-http --host 0.0.0.0 --port 9000

# 別のACPサーバーに接続
acp-mcp-server --acp-url http://localhost:8001

Claude Desktopでの使用

Claude Desktopの設定に追加します：

{
  "mcpServers": {
    "acp-bridge": {
      "command": "uvx",
      "args": ["acp-mcp-server"]
    }
  }
}

✨ 主な機能

• 🔄 プロトコルブリッジ：ACPエージェントとMCPクライアントをシームレスに接続します。
• 🚀 複数のトランスポート：STDIO、SSE、およびStreamable HTTPをサポートします。
• 🤖 エージェントディスカバリー：ACPエージェントの自動検出と登録を行います。
• 🧠 スマートルーティング：リクエストを適切なエージェントにインテリジェントにルーティングします。
• 🔄 非同期サポート：同期および非同期操作を完全にサポートします。
• 💬 対話型セッション：複数ターンのエージェント対話をサポートします。
• 🌐 マルチモーダル：テキスト、画像、およびその他のコンテンツタイプを処理します。

📋 必要条件

• Python 3.11以上
• エージェントを備えた稼働中のACPサーバー
• プロトコル実装にFastMCP

🔧 設定

環境変数

• ACP_BASE_URL：ACPサーバーのURL（デフォルト: http://localhost:8000）

コマンドラインオプション

usage: acp-mcp-server [-h] [--transport {stdio,sse,streamable-http}] [--host HOST] [--port PORT] [--path PATH] [--acp-url ACP_URL] [--version]

options:
  -h, --help            このヘルプメッセージを表示して終了します
  --transport {stdio,sse,streamable-http}
                        トランスポートプロトコル（デフォルト: stdio）
  --host HOST           HTTPトランスポートのホストアドレス（デフォルト: 127.0.0.1）
  --port PORT           HTTPトランスポートのポート番号（デフォルト: 8000）
  --path PATH           HTTPトランスポートのURLパス（デフォルト: /mcp）
  --acp-url ACP_URL     ACPサーバーのURL（デフォルト: http://localhost:8000）
  --version             プログラムのバージョン番号を表示して終了します

🛠️ 利用可能なツール

ブリッジサーバーはいくつかのMCPツールを提供します：

エージェント管理

• discover_acp_agents：利用可能なACPエージェントを検出します。
• get_agent_info：特定のエージェントの詳細情報を取得します。

エージェント実行

• run_acp_agent：エージェントを同期/非同期モードで実行します。
• get_async_run_result：非同期実行の結果を取得します。
• list_active_runs：すべてのアクティブなエージェント実行をリストします。

スマートルーティング

• smart_route_request：リクエストを最適なエージェントにインテリジェントにルーティングします。
• test_routing：実行せずにルーティングロジックをテストします。
• add_routing_rule：カスタムルーティングルールを追加します。
• list_routing_strategies：すべてのルーティング戦略を表示します。

対話型セッション

• start_interactive_agent：対話型エージェントセッションを開始します。
• provide_user_input：待機中のエージェントに入力を提供します。
• list_pending_interactions：保留中の対話を表示します。

メッセージ処理

• convert_acp_message：ACPとMCP形式の間でメッセージを変換します。
• analyze_message_content：メッセージの構造と内容を分析します。

🏗️ アーキテクチャ

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   MCP Client    │    │  ACP-MCP Bridge │    │   ACP Agents    │
│ (Claude Desktop)│◄──►│     Server      │◄──►│ (echo, chat,    │
│                 │    │                 │    │  translate...)  │
└─────────────────┘    └─────────────────┘    └─────────────────┘
       │                         │                       │
   MCP Protocol            Protocol Bridge         ACP Protocol
  (STDIO/SSE/HTTP)        (FastMCP + aiohttp)    (HTTP/WebSocket)

🔌 トランスポートモード

STDIO（デフォルト）

Claude Desktopとの統合に最適です：

acp-mcp-server

SSE（Server-Sent Events）

ウェブアプリケーションとストリーミングに適しています：

acp-mcp-server --transport sse --port 8000

Streamable HTTP

REST APIとの統合に適しています：

acp-mcp-server --transport streamable-http --port 9000

🐳 Docker

Dockerでのクイックスタート

# イメージをビルド
docker build -t acp-mcp-server .

# Streamable HTTPトランスポートで実行
docker run -p 9000:9000 acp-mcp-server

# SSEトランスポートで実行
docker run -p 8000:8000 acp-mcp-server \
  --transport sse --host 0.0.0.0 --port 8000

# カスタムACPサーバーに接続
docker run -p 9000:9000 -e ACP_BASE_URL=http://my-acp-server:8001 acp-mcp-server

Docker Composeの使用

# HTTPトランスポートサービスを実行
docker-compose up acp-mcp-http

# SSEトランスポートサービスを実行
docker-compose up acp-mcp-sse

# 両方のサービスを実行
docker-compose up

# ライブコードリロードで開発モードを実行
docker-compose --profile dev up acp-mcp-dev

本番用Dockerイメージ

本番環境でのデプロイには、マルチステージのDockerfileを使用します：

# 本番用イメージをビルド
docker build -f Dockerfile.prod -t acp-mcp-server:prod .

# 本番用コンテナを実行
docker run -d \
  --name acp-mcp-server \
  --restart unless-stopped \
  -p 9000:9000 \
  -e ACP_BASE_URL=http://your-acp-server:8000 \
  acp-mcp-server:prod

🤝 コントリビューション

コントリビューションは大歓迎です！ご自由にプルリクエストを送信してください。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細についてはLICENSEファイルを参照してください。

🔗 関連プロジェクト

• FastMCP - 高速でPythonicなMCPサーバーフレームワーク
• ACP SDK - エージェント通信プロトコルSDK
• Claude Desktop - MCPをサポートするAIアシスタント

📞 サポート

• 🐛 問題を報告
• 💬 ディスカッション
• 📖 ドキュメント