当前位置：首页 > news >正文

A2A MCP 集成

news 2025/8/4 7:55:37

仓库地址：A2A MCP

本仓库演示了如何设置和使用 a2a-python SDK 来创建一个简单的服务器和客户端实现 a2a 协议，其中代理服务器由 mcp 实现。

概述

A2A (Agent-to-Agent)： 用于构建可互操作 AI 代理的协议和 SDK。
本示例： 展示如何运行基本的 A2A 服务器和客户端，交换消息并查看响应。

前置条件

Python 3.13+
uv（用于快速依赖管理和运行）
OpenRouter 的 API 密钥（设置为 OPENROUTER_API_KEY）

安装

克隆仓库：

git clone https://github.com/sing1ee/a2a-mcp-openrouter
cd https://github.com/sing1ee/a2a-mcp-openrouter

安装依赖：

uv venv
source .venv/bin/activate
uv sync

设置环境变量：
```
export OPENROUTER_API_KEY=your-openrouter-api-key
```
或创建一个 .env 文件：
```
OPENROUTER_API_KEY=your-openrouter-api-key
```
注意： 您可以从 https://openrouter.ai/ 获取您的 OpenRouter API 密钥

运行示例

1. 启动服务器

uv run --env-file .env a2a-server

服务器将在端口 9999 上启动。

验证代理卡片：

a2a 协议验证器
指南：如何验证您的代理卡片

2. 运行客户端

在新终端中：

uv venv
source .venv/bin/activateuv run --env-file .env a2a-client --question "What is A2A protocol?"

客户端将连接到服务器并发送请求。

3. 查看响应

客户端的响应将保存到 response.xml。

配置

系统使用以下配置：

模型： 通过 OpenRouter 使用 google/gemini-flash-1.5
基础 URL： https://openrouter.ai/api/v1

文件结构

src/a2a_mcp_openrouter/server/：服务器实现。
src/a2a_mcp_openrouter/client/：客户端实现。
response.xml：客户端的示例响应。

故障排除

缺少依赖： 确保您已安装 uv。
API 密钥错误： 确保 OPENROUTER_API_KEY 设置正确。
端口冲突： 确保端口 9999 空闲。

A2A vs MCP：协议相似性和统一方法

通过这个实现，我们发现 A2A (Agent-to-Agent) 和 MCP (Model Context Protocol) 具有显著的架构相似性。两个协议都遵循类似的发现、能力交换和执行模式。

统一实现模式

关键发现：A2A 和 MCP 都遵循相同的底层实现模式：

基于 HTTP 的通信：两者都使用 HTTP 进行通信（A2A 使用 REST API，MCP 使用服务器发送事件）
提示驱动设计：两者都依赖 LLM 提示来决定调用什么以及如何调用
发现机制：两者都提供发现可用能力的方法
结构化响应：两者都返回可以程序化处理的结构化数据

查看 mcp.py 实现，我们可以看到：

# 通过 HTTP 进行 MCP 工具发现
async with sse_client(url) as (read, write):resources = await session.list_tools()# 为 LLM 决策生成提示
return template.render(tools=resources.tools)# 通过 HTTP 执行工具调用
return await session.call_tool(tool_name, arguments=arguments)