Azure AHDS FHIR MCP 服务器🚀

Azure 健康数据服务 FHIR（快速医疗保健互操作性资源）的模型上下文协议 (MCP) 服务器实现。此服务提供与 Azure FHIR 服务器交互的标准化接口，支持通过 MCP 工具进行医疗保健数据操作。

Python 版本微胶囊钙

设置🛠️

安装📦

需要 Python 3.13 或更高版本。

使用pip安装包：

pip install azure-fhir-mcp-server

MCP 配置⚙️

Claude桌面配置

1 - 编辑Claude桌面配置：

打开claude_desktop_config.json并添加以下配置。

在 MacOs 上，该文件位于此处： ~/Library/Application Support/Claude Desktop/claude_desktop_config.json 。

在 Windows 上，该文件位于此处： %APPDATA%\Claude Desktop\claude_desktop_config.json 。

{
    "mcpServers": {
        "fhir": {
            "command": "azure-fhir-mcp-server",
            "env": {
                "LOG_LEVEL": "INFO",
                "fhirUrl": "https://your-fhir-server.azurehealthcareapis.com/fhir",
                "clientId": "your-client-id",
                "clientSecret": "your-client-secret",
                "tenantId": "your-tenant-id"
            }
        }
    }
}

以下是可用的环境配置变量表：

多变的	描述	默认
`LOG_LEVEL`	日志级别	`INFO`
`fhirUrl`	Azure FHIR 服务器 URL	必需的
`clientId`	OAuth2 客户端 ID	必需的
`clientSecret`	OAuth2 客户端密钥	必需的
`tenantId`	Azure AD 租户 ID	必需的

2 - 重新启动 Claude Desktop。

可用工具🔧

FHIR 资源操作

search_fhir - 根据搜索参数字典搜索 FHIR 资源

资源访问

服务器通过 MCP 资源协议提供对所有标准 FHIR 资源的访问：

fhir://Patient/ - 访问所有患者资源
fhir://Patient/{id} - 访问特定的患者资源
fhir://Observation/ - 访问所有观察资源
fhir://Observation/{id} - 访问特定的观察资源
fhir://Medication/ - 访问所有药物资源
fhir://Medication/{id} - 访问特定的药物资源
还有更多...

Related MCP server: HAPI-MCP

发展💻

本地开发设置

1-克隆存储库：

git clone https://github.com/erikhoward/azure-fhir-mcp-server.git
cd azure-fhir-mcp-server

2-创建并激活虚拟环境：

Linux/macOS：

python -m venv .venv
source .venv/bin/activate

视窗：

python -m venv .venv
.venv\Scripts\activate

3 - 安装依赖项：

pip install -e ".[dev]"

4-复制并配置环境变量：

cp .env.example .env

使用您的设置编辑 .env：

fhirUrl=https://your-fhir-server.azurehealthcareapis.com/fhir
clientId=your-client-id
clientSecret=your-client-secret
tenantId=your-tenant-id

5 - Claude桌面配置

打开claude_desktop_config.json并添加以下配置。

在 MacOs 上，该文件位于此处： ~/Library/Application Support/Claude Desktop/claude_desktop_config.json 。

在 Windows 上，该文件位于此处： %APPDATA%\Claude Desktop\claude_desktop_config.json 。

{
    "mcpServers": {
        "fhir": {
            "command": "python",
            "args": [
                "-m",
                "fhir_mcp_server.server"
            ],
            "cwd": "/path/to/azure-fhir-mcp-server/repo",
            "env": {
                "LOG_LEVEL": "DEBUG",
                "fhirUrl": "https://your-fhir-server.azurehealthcareapis.com/fhir",
                "clientId": "your-client-id",
                "clientSecret": "your-client-secret",
                "tenantId": "your-tenant-id"
            }
        }
    }
}

6 - 重新启动 Claude Desktop。