金大哥 - FHIR MCP 详情

article

README

🚀 @flexpa/mcp-fhir

这是一个基于 TypeScript 的 MCP 服务器，可连接到 FHIR 服务器。它具备与 FHIR 资源交互的核心 MCP 功能，能通过 fhir:// URI 访问 FHIR 资源，还可搜索 FHIR 资源。

🚀 快速开始

⚠️ 重要提示

这是一个实验性的演示，不建议用于生产环境。

✨ 主要特性

资源

💡 使用建议

这里的 "资源" 指的是 MCP 的定义，而不是 FHIR。MCP 资源是模型上下文协议（MCP）中的核心原语，允许服务器公开数据和内容，以便客户端读取并作为 LLM 交互的上下文使用。

可列出并通过 URI 访问 FHIR 资源。
返回 FHIR JSON 格式的资源。
支持 FHIR 服务器 CapabilityStatement 中可用的所有 FHIR 资源类型。

工具

search_fhir - 搜索 FHIR 资源
- 接受 resourceType 和 searchParams 作为参数。
- 返回 FHIR 搜索结果。
read_fhir - 读取单个 FHIR 资源
- 接受 uri 作为参数。
- 返回 JSON 格式的 FHIR 资源。

📦 安装指南

服务器配置

服务器需要以下环境变量： | 属性 | 详情 | |------|------| | FHIR_BASE_URL | 您的 FHIR 服务器的基础 URL | | FHIR_ACCESS_TOKEN | SMART on FHIR 访问令牌用于身份验证 |

安装依赖与构建

安装依赖项：

npm install

构建服务器：

npm run build

带有自动重建的开发：

npm run watch

与 Claude Desktop 集成

要与 Claude Desktop 一起使用，请添加服务器配置：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fhir": {
      "command": "/path/to/@flexpa/mcp-fhir/build/index.js"
    },
    "env": {
      "FHIR_BASE_URL": "<FHIR_BASE_URL>",
      "FHIR_ACCESS_TOKEN": "<FHIR_ACCESS_TOKEN>"
    }
  }
}

调试

由于 MCP 服务器通过 stdio 通信，调试可能具有挑战性。我们建议使用 MCP Inspector，它作为包脚本提供：

npm run inspector

Inspector 将提供一个访问浏览器中的调试工具的 URL。

FHIR