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

一个模型上下文协议 (MCP) 服务器，它为与 Google Cloud Healthcare API 上的 FHIR 资源以及像 PubMed 这样的公共医学研究 API 交互提供医疗保健工具，使用像 Claude 和 Goose 这样的 MCP 客户端。

这是 AgentCare MCP Server for EHRs 的一个稍微修改的版本。https://github.com/Kartha-AI/agentcare-mcp

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

架构

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

演示

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

截图

<img src="screenshots/goose/goose-auth.png" alt="Auth" width="700"> <img src="screenshots/goose/goose-patient.png" alt="Patient" width="700"> <img src="screenshots/goose/goose-conditions.png" alt="Conditions" width="700"> <img src="screenshots/goose/goose-vitals.png" alt="Vitals" width="700">

<img src="screenshots/claude/gchapi.png" alt="GCHAPI" width="700"> <img src="screenshots/claude/convo.png" alt="Converse" width="700"> <img src="screenshots/claude/chart.png" alt="Timeline" width="700"> <img src="screenshots/claude/soap.png" alt="Soap Notes" 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 Desktop 一起使用

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"
      }
    }
  }
}

使用 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 desktop 正在运行，它会使用端口 3456 进行身份验证。您需要使用以下命令终止该进程：

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