用于 Google Cloud Healthcare API (FHIR) 的 MCP 服务器

这是一个 Model Context Protocol (MCP) 服务器，提供了与 Google Cloud Healthcare API 和像 pubmed 这样的公共医学研究 API 交互的医疗工具，使用如 Claude 和 Goose 等 MCP 客户端。

这是针对 EHRs 的 AgentCare MCP 服务器的一个略微修改版本。https://github.com/Kartha-AI/agentcare-mcp

主要区别在于这个仓库通过一个由 Firebase Auth 保护的 SmartonFHIR 网关与 Google Cloud Healthcare FHIR API 通信。

架构

<img src="screenshots/architecture.png" alt="架构" width="700">

演示

• Claude: demo/claude-demo.mp4
• Goose: demo/goose-demo.mp4

屏幕截图

<img src="screenshots/goose/goose-auth.png" alt="认证" width="700"> <img src="screenshots/goose/goose-patient.png" alt="患者" width="700"> <img src="screenshots/goose/goose-conditions.png" alt="状况" width="700"> <img src="screenshots/goose/goose-vitals.png" alt="生命体征" width="700"> <img src="screenshots/claude/gchapi.png" alt="GCHAPI" width="700"> <img src="screenshots/claude/convo.png" alt="对话" width="700"> <img src="screenshots/claude/chart.png" alt="时间线" width="700"> <img src="screenshots/claude/soap.png" alt="SOAP 记录" width="700">

工具

FHIR 工具

• find_patient - 通过姓名、出生日期或其他标识符搜索患者
• get_patient_observations - 获取患者的观察/生命体征
• get_patient_conditions - 获取患者的当前疾病
• get_patient_medications - 获取患者的当前药物
• get_patient_encounters - 获取患者的临床就诊记录
• get_patient_allergies - 获取患者的过敏和不耐受情况
• get_patient_procedures - 获取患者的手术
• get_patient_careteam - 获取患者的护理团队成员
• get_patient_careplans - 获取患者的活跃护理计划
• get_vital_signs - 获取患者的生命体征
• get_lab_results - 获取患者的实验室结果
• get_medications_history - 获取患者的用药历史
• clinical_query - 执行自定义 FHIR 查询

医学研究工具

• search-pubmed - 搜索与医疗状况相关的 PubMed 文章
• search-trials - 查找相关临床试验
• drug-interactions - 检查药物相互作用

使用方法

每个工具都需要特定的参数：

必需参数

• 大多数工具需要 patientId
• 一些工具有额外的参数：
  • lab_trend_analysis: 需要 labType
  • search-pubmed: 需要 query，可选 maxResults
  • search-trials: 需要 condition，可选 location
  • drug-interactions: 需要 drugs 数组

参考：/src/server/constants/tools.ts 了解工具的具体说明

与 claude 桌面版一起使用

for claude desktop: 
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
(use the env variables as shown above)

{
  "mcpServers": {
    "google-cloud-healthcare-api-mcp": {
      "command": "node",
      "args": [
        "/Users/your-username/{google-cloud-healthcare-api-mcp dir}/build/index.js"
      ],
      "env": {
          "FIREBASE_API_KEY":"XXXXXXXXX",
          "FIREBASE_AUTH_DOMAIN":"XXXXXXXX",
          "FIREBASE_PROJECT_ID":"XXXXXXX",
          "FIREBASE_STORAGE_BUCKET":"XXXXXXXXX",
          "FIREBASE_MESSAGING_SENDER_ID":"XXXXXXX",
          "FIREBASE_APP_ID":"XXXXXXXXX",
          "FIREBASE_MEASUREMENT_ID":"XXXXXXXX",
          "FIREBASE_AUTH_CALLBACK_PORT":"3456",
          "FHIR_BASE_URL":"{gchapi-fhir-gateway-host}/fhir",
          "PUBMED_API_KEY":"your_pubmed_api_key",
          "CLINICAL_TRIALS_API_KEY":"your_trials_api_key",
          "FDA_API_KEY":"your_fda_api_key"
      }
    }
  }
}

通过 Smithery 安装

要通过Smithery自动为Claude Desktop安装google-cloud-healthcare-api-mcp:

npx -y @smithery/cli install @Kartha-AI/google-cloud-healthcare-api-mcp --client claude

使用MCP Inspector本地启动MCP服务器

git clone git@github.com:Kartha-AI/google-cloud-healthcare-api-mcp.git
cd google-cloud-healthcare-api-mcp
npm install
npm run build
npm install -g @modelcontextprotocol/inspector
mcp-inspector  build/index.js
http://localhost:5173
Set up the env vars on Inspector

故障排除：

如果Claude桌面正在运行，它会使用3456端口进行身份验证。你需要使用以下命令终止该进程：

kill -9 $(lsof -t -i:3456)