ACP-MCP-Server

What is 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.

How to use ACP-MCP-Server?

Install via pip or uvx, then run with a chosen transport: STDIO (default), SSE, or Streamable HTTP. Configure via command-line options or environment variable ACP_BASE_URL. Use it in Claude Desktop by adding a configuration entry.

Key features of ACP-MCP-Server

• Protocol bridge connecting ACP agents with MCP clients
• Supports STDIO, SSE, and Streamable HTTP transports
• Automatic discovery and registration of ACP agents
• Smart routing of requests to appropriate agents
• Support for synchronous and asynchronous agent execution
• Multi-turn interactive agent sessions

Use cases of ACP-MCP-Server

• Integrating ACP-based AI agents with Claude Desktop via MCP
• Building web applications that interact with ACP agents using SSE
• Exposing ACP agents as REST APIs using Streamable HTTP
• Running multi-agent workflows with smart request routing
• Enabling interactive, multi-turn conversations with ACP agents

FAQ from ACP-MCP-Server

What transports does ACP-MCP-Server support?

STDIO (default for Claude Desktop), SSE (for web apps and streaming), and Streamable HTTP (for REST API integration).

What are the runtime requirements?

Python 3.11+, a running ACP server with agents, and FastMCP for protocol implementation.

How do I connect ACP-MCP-Server to a different ACP server?

Use the --acp-url command-line option or set the ACP_BASE_URL environment variable (default: http://localhost:8000).

Can I run ACP-MCP-Server in production?

Yes, there is a multi-stage Dockerfile for production deployments; use docker build -f Dockerfile.prod and run with restart policy.

How do I use ACP-MCP-Server with Claude Desktop?

Add a configuration entry with "command": "uvx" and "args": ["acp-mcp-server"] under mcpServers.