NHSUKMCP-Python

NHSUK MCP服务器

模型上下文协议（MCP）服务器，提供按类型和位置搜索NHS组织的工具，并使用Azure API管理访问NHS健康信息。

特性

• 获取组织类型：列出所有24种可用的NHS组织类型
• 转换邮政编码：将英国邮政编码转换为纬度/经度坐标
• 按邮政编码搜索：查找特定邮政编码附近的NHS组织
• 按坐标搜索：查找特定坐标附近的NHS组织
• 获取健康主题：获取详细的NHS健康信息和医疗状况指导

安装

来自PyPI（推荐）

pip install nhsuk-mcp

来源

git clone https://github.com/sinclr4/nhsuk-mcp-python.git
cd nhsuk-mcp-python
pip install -e .

配置

环境变量

此服务器需要两个环境变量：

• API_MANAGEMENT_ENDPOINT -Azure API管理基础URL（无服务路径）
• API_MANAGEMENT_SUBSCRIPTION_KEY -API管理的订阅密钥

使用Claude Desktop

安装

pip install nhsuk-mcp

配置

添加到您的Claude Desktop配置文件中：

macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "nhsuk": {
      "command": "python",
      "args": ["-m", "nhsuk_mcp.server"],
      "env": {
        "API_MANAGEMENT_ENDPOINT": "https://nhsuk-apim-int-uks.azure-api.net",
        "API_MANAGEMENT_SUBSCRIPTION_KEY": "your-subscription-key-here"
      }
    }
  }
}

视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "nhsuk": {
      "command": "python",
      "args": ["-m", "nhsuk_mcp.server"],
      "env": {
        "API_MANAGEMENT_ENDPOINT": "https://nhsuk-apim-int-uks.azure-api.net",  
        "API_MANAGEMENT_SUBSCRIPTION_KEY": "your-subscription-key-here"
      }
    }
  }
}

重新启动克劳德桌面

更新配置后，重新启动Claude Desktop。MCP服务器将提供5个工具。

可用的MCP工具

1.get_organization_types

列出所有NHS组织类型及其描述。

退货：组织类型代码及其描述词典。

示例类型:

• PHA -药房
• GPP -GP实践
• HOS -医院
• DEN -牙医
• CLI -诊所

2.convert_postcode_to_cords

将英国邮政编码转换为纬度/经度坐标。

参数:

• postcode （字符串，必填）：英国邮政编码（例如，“SW1A 1AA”）

退货：经纬度坐标

3.搜索_组织_邮政编码

搜索特定邮政编码附近的NHS组织。

参数:

• organisationType （字符串，必填）：组织类型代码（例如“PHA”、“GPP”、“HOS”）
• postcode （string，必填）：英国邮政编码
• maxResults （整数，可选）：最大结果数（1-50，默认值：10）

退货：包含名称、地址、邮政编码、距离和坐标的组织列表

4.搜索_组织_坐标

搜索特定坐标附近的NHS组织。

参数:

• organisationType （字符串，必填）：组织类型代码
• latitude （数字，必填）：纬度坐标
• longitude （数字，必填）：经度坐标
• maxResults （整数，可选）：最大结果数（1-50，默认值：10）

退货：包含名称、地址、邮政编码、距离和坐标的组织列表

5.获取健康主题

从NHS API获取有关特定健康状况或主题的详细信息。

参数:

• topic （字符串，必需）：健康主题或病症（例如，“哮喘”、“糖尿病”、“流感”、“新冠肺炎”）

退货：综合信息，包括名称、描述、上次审核日期、URL和内容部分

示例主题：哮喘、糖尿病、流感、新冠肺炎、心脏病、中风、癌症、抑郁症、焦虑症

支持的组织类型

服务器支持24种NHS组织类型：

Docker部署

构建图像

docker build -t nhs-orgs-mcp-python .

运行容器

docker run -i \
  -e API_MANAGEMENT_ENDPOINT="https://nhsuk-apim-int-uks.azure-api.net" \
  -e API_MANAGEMENT_SUBSCRIPTION_KEY="your-key" \
  nhs-orgs-mcp-python

示例用法

在Claude Desktop中配置后，您可以提出以下问题：

• “NHS有哪些组织类型？”

• “查找邮政编码SW1A 1AA附近的药店”

• “让我看看伦敦5英里范围内的全科医生诊所”

• “离坐标51.5074，-0.1278最近的医院是哪家？”

• “将邮政编码M1 1AE转换为坐标”

• “获取有关哮喘的信息”

• “告诉我糖尿病的症状和治疗”

• “NHS对流感的指导是什么？”

发展

本地设置

# Clone repository
git clone https://github.com/sinclr4/nhsuk-mcp-python.git
cd nhsuk-mcp-python

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install in development mode
pip install -e .

# Set environment variables
export API_MANAGEMENT_ENDPOINT="https://nhsuk-apim-int-uks.azure-api.net"
export API_MANAGEMENT_SUBSCRIPTION_KEY="your-key"

# Run the server
python -m nhsuk_mcp.server

项目结构

nhsuk-mcp-python/
├── nhsuk_mcp/
│   ├── __init__.py          # Package initialization
│   ├── server.py            # MCP server implementation
│   ├── models.py            # Data models (Organisation, PostcodeResult)
│   └── azure_search.py      # API Management service integration
├── pyproject.toml           # Project metadata and dependencies
├── Dockerfile               # Container build configuration
└── README.md                # This file

需求

• Python 3.10或更高版本
• 依赖关系：

- mcp>=1.0.0 -模型上下文协议SDK - httpx>=0.27.0 -HTTP客户端 - pydantic>=2.0.0 -数据验证

许可证

MIT许可证-有关详细信息，请参阅许可证文件

链接

• PyPI: https://pypi.org/project/nhsuk-mcp/
• GitHub: https://github.com/sinclr4/nhsuk-mcp-python
• 问题: https://github.com/sinclr4/nhsuk-mcp-python/issues

作者

罗伯·辛克莱rob.sinclair@nhschoices.net

贡献

欢迎投稿！请随时提交拉取请求。