A2a Settlement MCP

a2a结算mcp

MCP服务器，允许任何AI代理访问A2A结算交易所。将Claude、Cursor、LangGraph或自定义代理连接到基于托管的结算，而无需特定于框架的集成代码。

建筑

Any MCP Client                        A2A-SE Exchange
(Claude, Cursor, LangGraph,           (http://localhost:3000)
 custom agents, etc.)                        │
        │                                    │
        │  MCP Protocol (stdio/SSE)          │
        ▼                                    │
┌──────────────────┐    HTTP/REST    ┌───────┴────────┐
│  MCP Server      │───────────────►│   Exchange     │
│  (this project)  │                │   API          │
│                  │◄───────────────│                 │
│  Tools:          │                └─────────────────┘
│  - register      │
│  - fund          │
│  - balance       │
│  - escrow        │
│  - dispute       │
│  - reputation    │
│  - history       │
└──────────────────┘

什么是MCP？

这 模型上下文协议 （MCP）是将AI应用程序连接到外部数据和工具的标准。MCP服务器公开 工具 代理可以发现并调用。此服务器将A2A结算交换操作作为MCP工具公开——代理的运行时中没有安装SDK，也没有特定于框架的适配器。

可用工具

注： 单租户模式。服务器使用一个 A2A_API_KEY.为 check_balance, fund_agent, create_escrow, release_escrow, refund_escrow, file_dispute，以及 get_history，the agent_id 必须与配置的帐户匹配。

安装

pip install -e .

或者从git（包括来自上游的a2a结算SDK）：

pip install git+https://github.com/a2a-settlement/a2a-settlement-mcp.git

快速开始

克劳德桌面版

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "a2a-settlement": {
      "command": "python",
      "args": ["-m", "a2a_settlement_mcp"],
      "env": {
        "A2A_EXCHANGE_URL": "http://localhost:3000",
        "A2A_API_KEY": "your-api-key"
      }
    }
  }
}

看 示例/claude_desktop.md 了解详情。

光标

添加 .cursor/mcp.json:

{
  "mcpServers": {
    "a2a-settlement": {
      "command": "python",
      "args": ["-m", "a2a_settlement_mcp"],
      "env": {
        "A2A_EXCHANGE_URL": "http://localhost:3000",
        "A2A_API_KEY": "your-api-key"
      }
    }
  }
}

看 examples/cursor_config.md 了解详情。

程序化（Python）

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

params = StdioServerParameters(
    command="python",
    args=["-m", "a2a_settlement_mcp"],
    env={"A2A_EXCHANGE_URL": "http://localhost:3000", "A2A_API_KEY": "your-key"},
)

async with stdio_client(params) as (read, write):
    async with ClientSession(read, write) as session:
        await session.initialize()
        tools = await session.list_tools()
        result = await session.call_tool("settlement_check_balance", {"agent_id": "your-account-id"})

看 examples/programmatic.py 举个完整的例子。

配置

复制 .env.示例 并根据需要进行调整。

码头工人

docker build -t a2a-settlement-mcp .
docker run -e A2A_EXCHANGE_URL=http://host.docker.internal:3000 \
           -e A2A_API_KEY=your-key \
           -p 3200:3200 \
           a2a-settlement-mcp

集装箱默认在端口3200上进行SSE运输。用env变量覆盖。

SSE传输（远程访问）

对于HTTP/远程访问，请使用SSE运行：

A2A_MCP_TRANSPORT=sse A2A_MCP_PORT=3200 a2a-settlement-mcp

客户端连接到 http://localhost:3200/sse （或配置的主机/端口）。

测试

pytest tests/ -v

相关项目

何时使用MCP与框架集成： MCP适用于任何MCP客户端（克劳德桌面、光标、自定义）。对于LangGraph、CrewAI、LiteLLM或ADK，特定于框架的包提供了本机模式（图节点、包装器、回调）。当您的代理运行时与框架无关或仅使用MCP时，请使用MCP。

• MCP Python SDK --MCP正式实施
• 模型上下文协议 --协议规范

许可证

MIT。看 许可证.