ACP MCP服务器
 ](https://badge.fury.io/py/acp-mcp-server)  
连接的网桥服务器 代理通信协议（ACP） 代理商与 模型上下文协议（MCP） 客户端，实现基于ACP的人工智能代理与Claude Desktop等MCP兼容工具之间的无缝集成。
✨ 特性
- 🔄 协议网桥：将ACP代理与MCP客户端无缝连接
- 🚀 多个传输：支持STDIO、SSE和流式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-serverSSE（服务器发送事件）
对于web应用程序和流媒体：
acp-mcp-server --transport sse --port 8000流式HTTP
对于REST API集成：
acp-mcp-server --transport streamable-http --port 9000🐳 码头工人
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🤝 贡献
欢迎投稿！请随时提交拉取请求。
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。