Health Claims MCP Server

医疗保健MCP+A2A服务器（模拟）

一个示例项目展示了 模型上下文协议（MCP） 和 代理到代理（A2A）通信 在健康保险索赔领域。

• mcp_server/ --FastMCP服务器公开8个医疗保健工具
• a2a/ --自定义A2A协议，带有4个通过JSON-RPC 2.0进行协调的专用代理
• run_a2a.py --运行所有代理的独立HTTP服务器

所有数据都是合成的，没有真正的PHI，也没有外部调用。

官方A2A SDK：The a2a-sdk （v1.0.1+）现在是A2A协议的官方Python库。此项目包含为培训目的而构建的自定义实现。

______________________________________________________________________

项目结构

healthcare-mcp/
├── mcp_server/                  # MCP server
│   ├── __init__.py
│   └── server.py                # FastMCP with 8 healthcare tools
├── a2a/                         # A2A protocol implementation
│   ├── __init__.py
│   ├── message.py               # JSON-RPC 2.0 message types
│   ├── a2a_protocol.py          # Protocol engine, registry, routing
│   └── agents.py                # 4 healthcare domain agents
├── run_a2a.py                   # Standalone A2A HTTP server
├── test_a2a_communication.py    # A2A protocol tests (40 tests)
├── diagrams/
│   ├── mcp.mmd                  # MCP Gateway architecture
│   └── a2a.mmd                  # A2A messaging pattern
├── requirements.txt
└── pytest.ini

______________________________________________________________________

设置

先决条件： Python 3.10+

python -m venv .venv
source .venv/bin/activate      # Windows: .venv\Scripts\activate
pip install -r requirements.txt

______________________________________________________________________

运行MCP服务器

MCP服务器将医疗保健工具暴露给任何兼容MCP的客户端。

stdio（默认值--适用于MCP客户端）

python mcp_server/server.py

可流式传输的HTTP

export MCP_TRANSPORT=streamable-http
export FASTMCP_HOST=127.0.0.1
export FASTMCP_PORT=8000
python mcp_server/server.py

端点： http://127.0.0.1:8000/mcp

上海证券交易所

export MCP_TRANSPORT=sse
python mcp_server/server.py

MCP环境变量

______________________________________________________________________

运行A2A服务器

A2A服务器启动所有四个医疗保健代理，并通过HTTP公开它们。它使用一个本地MCP客户端，在进程中调用MCP工具函数——不需要单独的MCP服务器。

python run_a2a.py

服务器启动于 http://127.0.0.1:8001 默认情况下。

A2A环境变量

A2A端点

示例：发现代理

curl http://127.0.0.1:8001/.well-known/agent.json | python -m json.tool

示例：发送A2A消息

curl -s -X POST http://127.0.0.1:8001/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "check_member_eligibility",
    "params": {"member_id": "M-1001"},
    "id": "req-001",
    "sender": "external-client",
    "recipient": "claims-agent",
    "type": "request"
  }' | python -m json.tool

______________________________________________________________________

MCP工具

索赔

好处

供应商和授权

______________________________________________________________________

A2A代理系统

代理

通信流

MemberAssistAgent
    ├─ A2A → ClaimsAgent: "check_member_eligibility"
    │         ├─ MCP: list_member_claims, get_member_benefits
    │         └─ MCP: get_claim_detail
    │
    └─ A2A → ProviderAdvocateAgent: "search_network_providers"
              └─ MCP: search_providers

ClaimsAgent
    └─ A2A → BenefitsAgent: "calculate_member_responsibility"
              └─ MCP: estimate_member_responsibility

在代码中使用代理

import asyncio
from a2a import A2AProtocol, MemberAssistAgent, ClaimsAgent, ProviderAdvocateAgent, BenefitsAgent

async def main():
    protocol = A2AProtocol()

    member_assist     = MemberAssistAgent(protocol, mcp_client)
    claims            = ClaimsAgent(protocol, mcp_client)
    provider_advocate = ProviderAdvocateAgent(protocol, mcp_client)
    benefits          = BenefitsAgent(protocol, mcp_client)

    for agent in [member_assist, claims, provider_advocate, benefits]:
        await agent.register()

    protocol.register_handler("check_member_eligibility",        claims.handle_check_member_eligibility)
    protocol.register_handler("search_network_providers",        provider_advocate.handle_search_network_providers)
    protocol.register_handler("calculate_member_responsibility", benefits.handle_calculate_member_responsibility)

    eligibility = await member_assist.check_eligibility("M-1001")
    providers   = await member_assist.find_providers("primary care", "55401")

asyncio.run(main())

______________________________________________________________________

测试

pytest -v                          # all 40 tests
pytest test_a2a_communication.py   # A2A protocol tests only

看 测试_用户.md 用于测试文件和 QUICKSTART.md 用于过滤命令。

______________________________________________________________________

模拟数据参考

成员

计划

提供商

索赔

事先授权

______________________________________________________________________

架构图

渲染方式 美人鱼实时编辑器 或任何与Mermaid兼容的查看器。

______________________________________________________________________

MCP检查员

MCP检查员 是一个基于浏览器的工具，用于交互式调用MCP工具。

npm install
npm start

______________________________________________________________________

备注

• 所有数据都在内存中，并在重新启动时重置。
• estimate_member_responsibility 使用模拟乘数（75%在网络中，60%在网络外）。不是付款保证。
• 没有PHI，没有外部API调用，没有持久存储。
• 官方的A2A Python SDK是 a2a-sdk>=1.0.1The a2a/ 这个项目中的模块是相同协议模式的自定义教育实现。