使用说明

NPI注册表MCP服务器🏥

用于搜索国家提供商标识符（NPI）注册表的模型上下文协议（MCP）服务器。该服务器提供搜索和检索美国医疗服务提供者和组织信息的工具。

概述📋

NPI是美国受保医疗保健提供者的唯一识别码。此MCP服务器允许Claude和其他兼容MCP的客户端搜索由医疗保险和医疗补助服务中心（CMS）维护的官方NPI注册表，并将结果整合到LLM上下文中，以增强分析和见解。

特性✨

按提供商名称搜索：按名字、姓氏或两者查找个人医疗服务提供者
按组织搜索：按名称查找医疗机构
按NPI编号搜索：使用特定的10位NPI直接查找
基于位置的搜索：按城市、州或邮政编码筛选结果
专业搜索：根据专业或分类描述查找提供商
综合数据：返回详细信息，包括地址、练习地点、专业和其他标识符

用例💡

验证医疗保健提供者凭据
查找提供商联系信息和地址
查找组织详细信息和授权官员
验证NPI编号
研究提供者的专业和分类
查找特定地理区域的供应商

安装🚀

先决条件📋

Python 3.10或更高版本
紫外线包管理器

开发设置🛠️

克隆存储库:

git clone https://github.com/eliotk/npi-registry-mcp-server.git
cd npi-registry-mcp-server

安装uv （如果尚未安装）：

curl -LsSf https://astral.sh/uv/install.sh | sh

创建虚拟环境并安装依赖项:

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e ".[dev]"

直接运行服务器 （用于测试）：

uv run python -m npi_registry_mcp.server
# or using the entry point:
uv run npi-registry-mcp-server

生产装置🌟

从PyPI安装（发布后）：

uv pip install npi-registry-mcp-server

或者从源代码安装：

uv pip install git+https://github.com/eliotk/npi-registry-mcp-server.git

用法📚

可用工具🛠️

`search_npi_registry` 🔎

使用各种条件搜索NPI注册表：

参数：

first_name （可选）：提供者的名字
last_name （可选）：提供者的姓氏
organization_name （可选）：组织名称
npi （可选）：特定的10位NPI编号
city （可选）：城市名称
state （可选）：州缩写（例如“CA”、“NY”）
postal_code （可选）：邮政编码（支持通配符）
specialty （可选）：提供商专业或分类
limit （可选）：返回的最大结果数（1-200，默认值：10）

示例：

# Search for a specific provider by name
search_npi_registry(first_name="John", last_name="Smith", state="CA")

# Look up a specific NPI
search_npi_registry(npi="1234567890")

# Find organizations in a city
search_npi_registry(organization_name="Hospital", city="Los Angeles", state="CA")

# Search by specialty
search_npi_registry(specialty="cardiology", state="NY", limit=20)

# Find providers in a specific ZIP code area
search_npi_registry(postal_code="902*", state="CA")

响应格式📄

搜索返回一个结构化响应，其中包含：

{
  "success": true,
  "count": 5,
  "results": [
    {
      "npi": "1234567890",
      "entity_type": "Individual",
      "is_organization": false,
      "status": "A",
      "enumeration_date": "2010-05-05",
      "last_updated": "2023-01-15",
      "name": {
        "first": "John",
        "last": "Smith",
        "credential": "MD"
      },
      "addresses": [...],
      "practice_locations": [...],
      "taxonomies": [...],
      "identifiers": [...]
    }
  ]
}

Claude桌面配置🖥️

要将此MCP服务器与Claude Desktop一起使用，请将以下配置添加到您的Claude Desktop配置文件中：

macOS🍎

地点： ~/Library/Application Support/Claude/claude_desktop_config.json

视窗🪟

地点： %APPDATA%/Claude/claude_desktop_config.json

配置📝

{
  "mcpServers": {
    "npi-registry": {
      "command": "uv", # may need full path to executable
      "args": [
        "--directory",
        "/path/to/npi-registry-mcp-server",
        "run",
        "npi-registry-mcp-server"
      ]
    }
  }
}

验证✅

保存配置文件
完全重新启动克劳德桌面
寻找🔧 Claude Desktop中的图标，用于验证服务器是否已连接
试着问克劳德：“在加利福尼亚州寻找名叫史密斯的医生”

发展👨‍💻

项目结构📁

npi-registry-mcp-server/
├── src/
│   └── npi_registry_mcp/
│       ├── __init__.py
│       └── server.py
├── tests/
├── pyproject.toml
├── README.md
└── .gitignore

运行测试🧪

uv run pytest

代码格式化🎨

# Format code
uv run black src/ tests/

# Sort imports
uv run isort src/ tests/

# Lint
uv run ruff check src/ tests/

# Type checking
uv run mypy src/

构建包📦

uv build

api参考📖

此服务器使用CMS提供的官方NPI注册表API：

基本URL: https://npiregistry.cms.hhs.gov/api/
文档: https://npiregistry.cms.hhs.gov/registry/help-api
速率限制：API对正常使用有合理的费率限制

数据源🗃️

所有数据直接来自官方NPI注册表，由以下机构维护：

医疗保险和医疗补助服务中心（CMS）
美国卫生与公众服务部

贡献🤝

分叉存储库
创建要素分支： git checkout -b feature-name
进行更改并添加测试
运行测试套件： uv run pytest
设置代码格式： uv run black src/ tests/
提交拉取请求

许可证📄

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

支持🆘

问题：通过GitHub Issues报告错误和请求功能
文档：其他文件见 /docs 目录
API问题：参考官方NPI注册表API文件

更新日志📝

v0.1.0🎉

初始版本
基本的NPI注册表搜索功能
支持个人和组织搜索
位置和专业过滤
全面的提供商数据检索

有关模型上下文协议的更多信息，请访问：https://modelcontextprotocol.io/