Used as part of the protocol bridge to enable HTTP/WebSocket communication between MCP clients and ACP agents.
Provides containerized deployment options with different transport modes (HTTP, SSE) for production and development environments.
Offers issue reporting, discussions, and documentation access through GitHub repositories.
Makes the server available as a Python package that can be installed directly from PyPI.
ACP-MCP-Server
A bridge server that connects Agent Communication Protocol (ACP) agents with Model Context Protocol (MCP) clients, enabling seamless integration between ACP-based AI agents and MCP-compatible tools like Claude Desktop.
✨ Features
- 🔄 Protocol Bridge: Seamlessly connects ACP agents with MCP clients
- 🚀 Multiple Transports: Supports STDIO, SSE, and Streamable HTTP
- 🤖 Agent Discovery: Automatic discovery and registration of ACP agents
- 🧠 Smart Routing: Intelligent routing of requests to appropriate agents
- 🔄 Async Support: Full support for synchronous and asynchronous operations
- 💬 Interactive Sessions: Support for multi-turn agent interactions
- 🌐 Multi-Modal: Handle text, images, and other content types
🚀 Quick Start
Installation
Basic Usage
Using with Claude Desktop
Add to your Claude Desktop configuration:
📋 Requirements
- Python 3.11+
- Running ACP server with agents
- FastMCP for protocol implementation
🔧 Configuration
Environment Variables
ACP_BASE_URL
: ACP server URL (default:http://localhost:8000
)
Command Line Options
🛠️ Available Tools
The bridge server provides several MCP tools:
Agent Management
discover_acp_agents
: Discover available ACP agentsget_agent_info
: Get detailed information about specific agents
Agent Execution
run_acp_agent
: Execute agents in sync/async modesget_async_run_result
: Retrieve results from async executionslist_active_runs
: List all active agent runs
Smart Routing
smart_route_request
: Intelligently route requests to best agentstest_routing
: Test routing logic without executionadd_routing_rule
: Add custom routing ruleslist_routing_strategies
: View all routing strategies
Interactive Sessions
start_interactive_agent
: Start interactive agent sessionsprovide_user_input
: Provide input to waiting agentslist_pending_interactions
: View pending interactions
Message Processing
convert_acp_message
: Convert between ACP and MCP formatsanalyze_message_content
: Analyze message structure and content
🏗️ Architecture
🔌 Transport Modes
STDIO (Default)
Perfect for Claude Desktop integration:
SSE (Server-Sent Events)
For web applications and streaming:
Streamable HTTP
For REST API integration:
🐳 Docker
Quick Start with Docker
Using Docker Compose
Production Docker Image
For production deployments, use the multi-stage Dockerfile:
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🔗 Related Projects
- FastMCP - Fast, Pythonic MCP server framework
- ACP SDK - Agent Communication Protocol SDK
- Claude Desktop - AI assistant with MCP support
📞 Support
This server cannot be installed
A bridge server that connects Agent Communication Protocol (ACP) agents with Model Context Protocol (MCP) clients, enabling seamless integration between ACP-based AI agents and MCP-compatible tools like Claude Desktop.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol (MCP) server that allows AI agents like Claude to interact with the Aligo SMS API to send text messages and retrieve related information.Last updated -JavaScriptMIT License
- -security-license-qualityAn open-source implementation of the Model Context Protocol (MCP) that bridges AI agents with enterprise systems, enabling secure access to real-world data and capabilities.Last updated -1PythonApache 2.0
- -securityFlicense-qualityAn MCP server that enables Claude Desktop to communicate with A2A protocol agents, allowing Claude to access extended capabilities through agent interactions.Last updated -7Python
- AsecurityFlicenseAqualityAn all-in-one Model Context Protocol (MCP) server that connects your coding AI to numerous databases, data warehouses, data pipelines, and cloud services, streamlining development workflow through seamless integrations.Last updated -Python