ACP-MCP-Server

ACP-MCP-Server

**Agent Communication Protocol（ACP）エージェントとModel Context Protocol（MCP）**クライアントを接続するブリッジサーバーです。ACP ベースの AI エージェントと、Claude Desktop などの MCP 対応ツールをシームレスに統合できます。

✨ 特長

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

🚀 クイックスタート

インストール

# Install from PyPI
pip install acp-mcp-server

# Or use uvx for isolated execution
uvx acp-mcp-server

基本的な使い方

# Run with STDIO (default, for Claude Desktop)
acp-mcp-server

# Run with SSE transport
acp-mcp-server --transport sse --port 8000

# Run with HTTP transport
acp-mcp-server --transport streamable-http --host 0.0.0.0 --port 9000

# Connect to different ACP server
acp-mcp-server --acp-url http://localhost:8001

Claude Desktop での使用

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

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

📋 要件

• 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            show this help message and exit
  --transport {stdio,sse,streamable-http}
                        Transport protocol (default: stdio)
  --host HOST           Host address for HTTP transports (default: 127.0.0.1)
  --port PORT           Port number for HTTP transports (default: 8000)
  --path PATH           URL path for HTTP transports (default: /mcp)
  --acp-url ACP_URL     ACP server URL (default: http://localhost:8000)
  --version             show program's version number and exit

🛠️ 利用可能なツール

ブリッジサーバーは、次の 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）

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

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

Streamable HTTP

REST API との連携に適しています：

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

🐳 Docker

Docker を使ったクイックスタート

# Build the image
docker build -t acp-mcp-server .

# Run with Streamable HTTP transport
docker run -p 9000:9000 acp-mcp-server

# Run with SSE transport
docker run -p 8000:8000 acp-mcp-server \
  --transport sse --host 0.0.0.0 --port 8000

# Connect to custom ACP server
docker run -p 9000:9000 -e ACP_BASE_URL=http://my-acp-server:8001 acp-mcp-server

Docker Compose の使用

# Run HTTP transport service
docker-compose up acp-mcp-http

# Run SSE transport service
docker-compose up acp-mcp-sse

# Run both services
docker-compose up

# Run development mode with live code reload
docker-compose --profile dev up acp-mcp-dev

本番環境向け Docker イメージ

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

# Build production image
docker build -f Dockerfile.prod -t acp-mcp-server:prod .

# Run production container
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

🤝 コントリビューション

コントリビューションを歓迎します！Pull Request をお気軽に送信してください。

📄 ライセンス

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

🔗 関連プロジェクト

• FastMCP - 高速で Python らしい MCP サーバーフレームワーク
• ACP SDK - Agent Communication Protocol SDK
• Claude Desktop - MCP に対応した AI アシスタント

📞 サポート

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