A2amcp

🚀 A2AMCP - 代理到代理模型上下文协议

A2AMCP 将谷歌的代理到代理（A2A）通信概念引入到模型上下文协议（MCP）生态系统中，使人工智能代理能够在并行开发任务中进行实时通信、协调和协作。它最初是为 SplitMind 创建的，解决了多个人工智能代理在同一代码库上工作时，彼此不知道对方更改的关键问题。

🚀 快速开始

使用 Docker（推荐）

# 克隆仓库
git clone https://github.com/webdevtodayjason/A2AMCP
cd A2AMCP

# 启动服务器
docker-compose up -d

# 验证服务器是否正在运行
docker ps | grep splitmind

# 测试连接
python verify_mcp.py

配置你的代理

Claude Code（命令行界面）

# 使用 Claude Code 命令行界面添加 MCP 服务器
claude mcp add splitmind-a2amcp \
  -e REDIS_URL=redis://localhost:6379 \
  -- docker exec -i splitmind-mcp-server python /app/mcp-server-redis.py

Claude 桌面版

在你的配置文件中添加（macOS 系统路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "splitmind-a2amcp": {
      "command": "docker",
      "args": ["exec", "-i", "splitmind-mcp-server", "python", "/app/mcp-server-redis.py"],
      "env": {
        "REDIS_URL": "redis://redis:6379"
      }
    }
  }
}

✨ 主要特性

1. 实时代理通信

• 代理之间的直接查询
• 广播消息
• 异步消息队列

2. 文件冲突预防

• 自动文件锁定
• 冲突检测
• 协商策略

3. 共享上下文管理

• 接口/类型注册表
• API 契约共享
• 依赖跟踪

4. 任务透明度

• 待办事项列表管理
• 进度可见性
• 完成跟踪
• 任务完成信号

5. 多项目支持

• 隔离的项目命名空间
• 基于 Redis 的持久化
• 自动清理

6. 现代 MCP 集成

• 使用带有适当装饰器的 MCP SDK 1.9.3
• @server.list_tools() 和 @server.call_tool() 模式
• 基于标准输入输出的通信协议
• 完全符合 A2AMCP API，实现并测试了 17 个工具

📦 安装指南

Docker Compose（生产环境）

services:
  mcp-server:
    build: .
    container_name: splitmind-mcp-server
    ports:
      - "5050:5000"  # 从 5000 更改以避免冲突
    environment:
      - REDIS_URL=redis://redis:6379
      - LOG_LEVEL=INFO
    depends_on:
      redis:
        condition: service_healthy
    restart: unless-stopped
  
  redis:
    image: redis:7-alpine
    container_name: splitmind-redis
    ports:
      - "6379:6379"
    volumes:
      - redis-data:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  redis-data:
    driver: local

Python SDK

pip install a2amcp-sdk

JavaScript/TypeScript SDK（即将推出）

npm install @a2amcp/sdk

💻 使用示例

Python SDK

from a2amcp import A2AMCPClient, Project, Agent

async def run_agent():
    client = A2AMCPClient("localhost:5000")
    project = Project(client, "my-app")
    
    async with Agent(project, "001", "feature/auth", "Build authentication") as agent:
        # 代理自动注册并保持心跳
        
        # 协调文件访问
        async with agent.files.coordinate("src/models/user.ts") as file:
            # 文件已锁定，可以安全修改
            pass
        # 文件自动释放
        
        # 共享接口
        await project.interfaces.register(
            agent.session_name,
            "User",
            "interface User { id: string; email: string; }"
        )

直接使用 MCP 工具

# 注册代理
register_agent("my-project", "task-001", "001", "feature/auth", "Building authentication")

# 查询另一个代理
query_agent("my-project", "task-001", "task-002", "interface", "What's the User schema?")

# 共享接口
register_interface("my-project", "task-001", "User", "interface User {...}")

📚 详细文档

• Claude Code 设置指南
• 安装与设置
• 完整 API 参考
• Python SDK 文档
• 架构概述
• SplitMind 集成指南

🔧 技术细节

架构

┌─────────────────┐
│   A2AMCP Server │ ← 基于 Redis 的持久化 MCP 服务器
│   (Port 5050)   │   处理所有代理通信
└────────┬────────┘
         │ 标准输入输出协议（MCP）
    ┌────┴────┬─────────┬─────────┐
    ▼         ▼         ▼         ▼
┌────────┐┌────────┐┌────────┐┌────────┐
│Agent 1 ││Agent 2 ││Agent 3 ││Agent N │
│Auth    ││Profile ││API     ││Frontend│
└────────┘└────────┘└────────┘└────────┘

与 A2A 的区别

🚀 路线图

• [x] 带有 Redis 的核心 MCP 服务器
• [x] 集成现代 MCP SDK 1.9.3
• [x] 修复装饰器模式（@server.list_tools()，@server.call_tool()）
• [x] Python SDK
• [x] Docker 部署
• [x] 实现并测试所有 17 个 A2AMCP API 工具
• [x] 用于监控的健康检查端点
• [x] 用于测试连接的验证脚本
• [ ] JavaScript/TypeScript SDK
• [ ] 命令行监控工具
• [ ] SplitMind 原生集成
• [ ] 框架适配器（LangChain，CrewAI）
• [ ] 企业功能

🛠️ 故障排除

代理无法看到 mcp__splitmind-a2amcp__ 工具

1. 重启 Claude 桌面版 - MCP 连接在启动时建立
2. 验证服务器是否正在运行：docker ps | grep splitmind
3. 检查健康端点：curl http://localhost:5050/health
4. 运行验证脚本：python verify_mcp.py
5. 检查配置：确保 ~/Library/Application Support/Claude/claude_desktop_config.json 包含 A2AMCP 服务器配置

常见问题

• “工具 'X' 尚未实现” - 最新版本已修复，请拉取最新更改
• 连接失败 - 确保 Docker 正在运行，并且端口 5050/6379 可用
• Redis 连接错误 - 等待 Redis 准备好（启动时大约需要 5 - 10 秒）

📄 许可证

本项目采用 MIT 许可证，请参阅 LICENSE 文件获取详细信息。

🙏 致谢

• 灵感来自 谷歌的 A2A 协议
• 为 SplitMind 构建
• 由 模型上下文协议 提供支持

📞 支持

• 问题反馈：GitHub 问题
• 讨论交流：GitHub 讨论
• Discord：即将推出