金大哥 - google-cloud-healthcare-api-mcp MCP 详情

article

README

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

本项目是一个Model Context Protocol (MCP) 服务器，可借助Claude和Goose等MCP客户端工具，实现与 Google Cloud Healthcare API 以及公开医学研究API（如pubmed）的交互。此版本是为与电子健康记录 (EHRs) 交互的 AgentCare MCP 服务器的略微修改版，详情可查看：https://github.com/Kartha-AI/agentcare-mcp 。主要区别在于，本仓库通过一个由 Firebase 身份验证保护的 Smart-on-FHIR 网关与 Google Cloud Healthcare FHIR API 进行通信。

🚀 快速开始

你可以在 Claude 桌面中自动安装此 MCP 服务器，借助 Smithery 完成操作：

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

若要在本地启动 MCP 服务器（使用 MCP Inspector），可按如下步骤操作：

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 ，并在 Inspector 中设置环境变量。

✨ 主要特性

提供与 Google Cloud Healthcare API 和公开医学研究 API 的交互功能。
通过 Firebase 身份验证保护的 Smart-on-FHIR 网关与 Google Cloud Healthcare FHIR API 通信。
提供多种 FHIR 工具，方便对患者信息进行操作。

📦 安装指南

自动安装

在 Claude 桌面中自动安装此 MCP 服务器，请使用 Smithery：

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

本地安装

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 ，并在 Inspector 中设置环境变量。

💻 使用示例

FHIR工具

find_patient - 按姓名、出生日期或其他标识符搜索患者
get_patient_observations - 获取患者的观察结果/生命体征
get_patient_conditions - 获取患者的活跃状况
get_patient_medications - 获取患者的当前药物
get_patient - 获取患者的详细信息
get_encounter - 获取患者的就诊记录
get_observation - 获取单个观察结果的详细信息

医学术语映射

| 中文术语 | 英文术语 | | ---- | ---- | | 患者 | Patient | | 病例 | Encounter | | 观察结果 | Observation | | 药物 | MedicationStatement |

🔧 技术细节

架构

文档中未详细提及架构相关内容，但可推测该 MCP 服务器通过 Firebase 身份验证保护的 Smart-on-FHIR 网关与 Google Cloud Healthcare FHIR API 通信，实现与电子健康记录的交互。

演示

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

截图

文档中未提供具体截图内容。

🚧 故障排除

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

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

google-cloud-healthcare-api-mcp