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 資源。

📦 安裝指南

要與 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_BASE_URL: 您的 FHIR 服務器的基礎 URL
• FHIR_ACCESS_TOKEN: SMART on FHIR 訪問令牌用於身份驗證

💻 使用示例

基礎用法

安裝依賴項：

npm install

構建服務器：

npm run build

帶有自動重建的開發：

npm run watch