AI导哈

FHIR资源搜索服务

一个用于在指定FHIR服务器上搜索FHIR资源的Python服务，支持命令行、Docker和VS Code集成。

  • by VimukthiRajapaksha
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 vimukthirajapaksha/healthcare-mcp-server

使用说明

医疗保健模型上下文协议（MCP）服务器

概述

此服务器允许您在指定的Contoso服务器上搜索Contoso（快速医疗保健互操作性资源）资源。它是用Python构建的，支持命令行、Docker和VS Code集成。

先决条件

  • Python 3.8+
  • 紫外线 （用于依赖关系管理）
  • 可访问的➤服务器（默认为公共HAPI Contoso测试服务器）

设置

  1. 克隆存储库：
    git clone <repository_url>
cd <repository_directory>
  2. 创建虚拟环境并安装依赖项：
    uv venv
source .venv/bin/activate
uv pip sync requirements.txt
    或者使用pip：
    python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
  3. 配置环境变量： 复制示例文件并根据需要进行自定义：
    cp .env.example .env

用法

运行服务器：

uv run server.py

VS代码集成

将以下JSON块添加到VS Code中的用户设置（JSON）文件中。您可以通过按Ctrl+Shift+P并键入首选项：打开用户设置（JSON）来完成此操作。

Streamable HTTPstdio
"mcp": {
    "servers": {
        "fhir": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "http://localhost:8000/mcp"
            ]
        }
    }
}

"mcp": {
    "servers": {
        "fhir": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/fhir-mcp-server",
                "run",
                "fhir-mcp-server",
                "--transport",
                "stdio"
            ],
            "env": {
                "HEALTHCARE_MCP_FHIR__ACCESS_TOKEN": "Your FHIR Access Token"
            }
        }
    }
}

Claude桌面集成

将以下JSON块添加到您的Claude Desktop设置中，以连接到本地MCP服务器。

  • 启动Claude Desktop应用程序，单击顶部栏中的Claude菜单，然后选择“设置…”。
  • 在“设置”窗格中，单击左侧边栏中的“开发人员”。然后单击“编辑配置”。这将在您的文件系统中打开您的配置文件。如果它还不存在，Claude将在以下位置自动创建一个：
    • macOS：~/库/应用程序支持/Claude/Claude_desktop_config json
    • Windows：%APPDATA%\Claude\Claude_desktop_config.json
  • 在任何文本编辑器中打开claude_desktop_config.json文件。用以下JSON块替换其内容以注册MCP服务器：
Streamable HTTPstdio
{
    "mcpServers": {
        "fhir": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "http://localhost:8000/mcp"
            ]
        }
    }
}

{
    "mcpServers": {
        "fhir": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/fhir-mcp-server",
                "run",
                "fhir-mcp-server",
                "--transport",
                "stdio"
            ],
            "env": {
                "HEALTHCARE_MCP_FHIR__ACCESS_TOKEN": "Your FHIR Access Token"
            }
        }
    }
}

MCP检查器集成

按照以下步骤启动并运行MCP检查器：

  • 打开终端并运行以下命令：

    npx -y @modelcontextprotocol/inspector

  • 在MCP检查器界面中：

Streamable HTTPstdio
  • 运输类型： Streamable HTTP
  • 网址： http://localhost:8000/mcp
  • 运输类型： STDIO
  • 命令： uv
  • 论据： --directory /path/to/fhir-mcp-server run fhir-mcp-server --transport stdio

确保您的MCP服务器已在上述端点上运行并侦听。

一旦连接，MCP Inspector将允许您可视化工具调用，检查请求/响应有效负载，并轻松调试您的工具实现。

示例提示

  • 获取患者53373的过敏史
  • 获取患者ID 53373的免疫记录
  • 列出患者22的所有主动护理计划
  • 为53373号患者提供一份综合报告，包括其完整的过敏史以及所有可用的免疫记录，按日期组织，并突出显示任何关键警报
  • 检索患者ID 22的所有活动护理计划，并将其显示在标记表中，显示每个计划的ID、标题、状态、意图和开始日期

相关 MCP