ACP to MCP Adapter
Bridge ACP Agents with MCP Applications Seamlessly
Key Features
Use Cases
README
Connect ACP Agents to MCP Applications Seamlessly
The ACP to MCP Adapter is a lightweight standalone server that acts as a bridge between two AI ecosystems: Agent Communication Protocol (ACP) for agent-to-agent communication and Model Context Protocol (MCP) for connecting AI models to external tools. It allows MCP applications (like Claude Desktop) to discover and interact with ACP agents as resources.
Capabilities & Tradeoffs
This adapter enables interoperability between ACP and MCP with specific benefits and tradeoffs:
Benefits
- Makes ACP agents discoverable as MCP resources
- Exposes ACP agent runs as MCP tools
- Bridges two ecosystems with minimal configuration
Current Limitations
- ACP agents become MCP tools instead of conversational peers
- No streaming of incremental updates
- No shared memory across servers
- Basic content translation between formats without support for complex data structures
This adapter is best for situations where you need ACP agents in MCP environments and accept these compromises.
Requirements
- Python 3.11 or higher
- Installed Python packages:
acp-sdk,mcp - An ACP server running (Tip: Follow the ACP quickstart to start one easily)
- An MCP client application (We use Claude Desktop in the quickstart)
Quickstart
1. Run the Adapter
Start the adapter and connect it to your ACP server:
uvx acp-mcp http://localhost:8000
[!NOTE] Replace
http://localhost:8000with your ACP server URL if different.
docker run -i --rm ghcr.io/i-am-bee/acp-mcp http://host.docker.internal:8000
Tip: host.docker.internal allows Docker containers to reach services running on the host (adjust if needed for your setup).
2. Connect via Claude Desktop
To connect via Claude Desktop, follow these steps:
- Open the Claude menu on your computer and navigate to Settings (note: this is separate from the in-app Claude account settings).
- Navigate to Developer > Edit Config
- The config file will be created here:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Edit the file with the following:
{
"mcpServers": {
"acp-local": {
"command": "uvx",
"args": ["acp-mcp", "http://localhost:8000"]
}
}
}
{
"mcpServers": {
"acp-docker": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/i-am-bee/acp-mcp",
"http://host.docker.internal:8000"
]
}
}
}
3. Restart Claude Desktop and Invoke Your ACP Agent
After restarting, invoke your ACP agent with:
use "echo" agent with the "Good morning!" input
Accept the integration and observe the agent running.
[!TIP] ACP agents are also registered as MCP resources in Claude Desktop. To attach them manually, click the Resources icon (two plugs connecting) in the sidebar, labeled "Attach from MCP", then select an agent like
acp://agents/echo.
How It Works
- The adapter connects to your ACP server.
- It automatically discovers all registered ACP agents.
- Each ACP agent is registered in MCP as a resource using the URI:
acp://agents/{agent_name} - The adapter provides a new MCP tool called
run_agent, letting MCP apps easily invoke ACP agents.
Supported Transports
- Currently supports Stdio transport
Developed by contributors to the BeeAI project, this initiative is part of the Linux Foundation AI & Data program. Its development follows open, collaborative, and community-driven practices.
Star History
Repository Owner
Organization
Repository Details
Programming Languages
Tags
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
OpenAI MCP Server
Bridge between Claude and OpenAI models using the MCP protocol.
OpenAI MCP Server enables direct querying of OpenAI language models from Claude via the Model Context Protocol (MCP). It provides a configurable Python server that exposes OpenAI APIs as MCP endpoints. The server is designed for seamless integration, requiring simple configuration updates and environment variable setup. Automated testing is supported to verify connectivity and response from the OpenAI API.
- ⭐ 77
- MCP
- pierrebrunelle/mcp-server-openai
Taskade MCP
Tools and server for Model Context Protocol workflows and agent integration
Taskade MCP provides an official server and tools to implement and interact with the Model Context Protocol (MCP), enabling seamless connectivity between Taskade’s API and MCP-compatible clients such as Claude or Cursor. It includes utilities for generating MCP tools from any OpenAPI schema and supports the deployment of autonomous agents, workflow automation, and real-time collaboration. The platform promotes extensibility by supporting integration via API, OpenAPI, and MCP, making it easier to build and connect agentic systems.
- ⭐ 90
- MCP
- taskade/mcp
Modbus MCP Server
Standardizes Modbus data for seamless AI integration via the Model Context Protocol.
Modbus MCP Server provides an MCP-compliant interface that standardizes and contextualizes Modbus device data for use with AI agents and industrial IoT systems. It supports flexible Modbus connections over TCP, UDP, or serial interfaces and offers a range of Modbus tools for reading and writing registers and coils. With customizable prompts and structured tool definitions, it enables natural language-driven interactions and analysis of Modbus data within AI workflows. The solution is designed to ensure interoperability and easy configuration within MCP-compatible environments.
- ⭐ 18
- MCP
- kukapay/modbus-mcp
docker-mcp
A powerful MCP server for seamless Docker container and compose stack management.
docker-mcp is a Model Context Protocol (MCP) server that enables robust Docker container and compose stack management via Claude AI. It offers easy installation through Smithery or manual setup, supporting container creation, Docker Compose stack deployment, log retrieval, and monitoring. Integration with the Claude Desktop app is straightforward, and the included MCP Inspector aids debugging. This tool simplifies Docker operations for automation and AI model interactions.
- ⭐ 419
- MCP
- QuantGeekDev/docker-mcp
MCP Link
Convert Any OpenAPI V3 API to an MCP Server for seamless AI Agent integration.
MCP Link enables automatic conversion of any OpenAPI v3-compliant RESTful API into a Model Context Protocol (MCP) server, allowing instant compatibility with AI-driven agent frameworks. It eliminates the need for manual interface creation and code modification by translating OpenAPI schemas into MCP endpoints. MCP Link supports robust feature mapping and authentication, making it easy to expose existing APIs to AI ecosystems using a standardized protocol. The tool is designed for both developers and organizations seeking to streamline API integration with AI agents.
- ⭐ 572
- MCP
- automation-ai-labs/mcp-link
Dune Analytics MCP Server
Bridge Dune Analytics data seamlessly to AI agents via a Model Context Protocol server.
Dune Analytics MCP Server provides a Model Context Protocol-compliant server that allows AI agents to access and interact with Dune Analytics data. It exposes tools to fetch the latest results of Dune queries and execute arbitrary queries, returning results in CSV format. The server is easily deployable, supports integration with platforms like Claude Desktop, and requires a Dune Analytics API key for operation.
- ⭐ 31
- MCP
- kukapay/dune-analytics-mcp
Didn't find tool you were looking for?