FHIR

一个实验性的TypeScript MCP服务器，用于连接FHIR服务器并提供核心MCP功能

健康与养生开发者工具 #FHIR连接 #资源搜索 #医疗数据远程 .TypeScript

评分 : 2.5分

下载量 : 7.4K

更新时间 : 2025-04-28

打开站点

什么是@flexpa/mcp-fhir?

这是一个连接到FHIR服务器的MCP服务器，允许用户通过统一的接口访问和操作FHIR资源。

如何使用@flexpa/mcp-fhir?

您可以通过简单的配置和命令行工具来设置和运行该服务器，然后使用它来查询和管理FHIR资源。

适用场景

适用于需要集成FHIR数据的医疗应用开发人员和研究者。

主要功能

列出FHIR资源

支持通过URI访问FHIR资源列表。

搜索FHIR资源

通过指定资源类型和参数进行高级搜索。

读取单个FHIR资源

根据URI读取特定的FHIR资源。

优势

易于集成现有FHIR系统

支持多种FHIR资源类型

开放源码，可定制性强

局限性

需要配置SMART on FHIR令牌

仅适用于实验环境，不适合生产部署

如何使用

安装依赖

运行npm install以安装所有必需的依赖项。

构建服务器

使用npm run build命令生成可执行文件。

启动服务器

在开发模式下运行npm run watch以实现自动重建。

使用案例

案例1：查询患者信息

通过FHIR接口查询患者的基本信息。

案例2：读取特定患者记录

读取指定患者的详细信息。

常见问题

如何设置SMART on FHIR令牌？

是否可以用于生产环境？

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