@flexpa/mcp-fhir

[!WARNING] 这是一个实验性演示，不适用于生产环境。

这是一个基于TypeScript的MCP服务器，连接到一个FHIR服务器。它提供了与FHIR资源交互的核心MCP功能，包括：

• 通过URI访问FHIR资源
• 提供搜索FHIR资源的功能

功能

资源

[!TIP] 这里的“资源”指的是MCP定义，而不是FHIR定义。MCP资源是模型上下文协议（MCP）中的核心原始数据类型，允许服务器暴露可以被客户端读取并用于LLM交互上下文的数据和内容。

• 列出并通过fhir://URI访问FHIR资源
• 资源以FHIR JSON格式返回
• 支持FHIR服务器能力声明中可用的所有FHIR资源类型

工具

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

配置

服务器需要以下环境变量：

• FHIR_BASE_URL：您的FHIR服务器的基础URL
• FHIR_ACCESS_TOKEN：用于身份验证的SMART on FHIR访问令牌

开发

安装依赖项：

npm install

构建服务器：

npm run build

开发时自动重建：

npm run watch

安装

要在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服务器通过标准I/O进行通信，调试可能会比较困难。我们推荐使用MCP Inspector，该工具作为一个包脚本提供：

npm run inspector

Inspector将提供一个URL，您可以通过浏览器访问调试工具。