Healthcare MCP Server (Vimukthirajapaksha)

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

概述

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

先决条件

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

设置

1. 克隆存储库：

   git clone 
   cd 

1. 创建虚拟环境并安装依赖项：

   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

1. 配置环境变量：

复制示例文件并根据需要进行自定义：

   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、标题、状态、意图和开始日期