Npi Registry MCP Server

🚀 NPI註冊MCP服務器 🏥

這是一個用於搜索美國國家提供者標識符（NPI）註冊庫的模型上下文協議（MCP）服務器。該服務器提供了搜索和檢索美國醫療保健提供者及組織信息的工具。

🚀 快速開始

本MCP服務器允許Claude及其他兼容MCP的客戶端搜索由美國醫療保險和醫療補助服務中心（CMS）維護的官方NPI註冊庫，並將搜索結果集成到大型語言模型（LLM）的上下文中，以進行更深入的分析和洞察。

✨ 主要特性

• 按提供者姓名搜索：通過名、姓或兩者結合查找個體醫療保健提供者。
• 按組織搜索：按名稱查找醫療保健組織。
• 按NPI編號搜索：使用特定的10位NPI編號直接查找。
• 基於位置的搜索：按城市、州或郵政編碼過濾搜索結果。
• 專業搜索：按專業或分類描述查找提供者。
• 全面的數據：返回詳細信息，包括地址、執業地點、專業和其他標識符。

💡 使用場景

• 驗證醫療保健提供者的資質。
• 查找提供者的聯繫信息和地址。
• 查找組織詳情和授權官員信息。
• 驗證NPI編號。
• 研究提供者的專業和分類。
• 查找特定地理區域的提供者。

📦 安裝指南

📋 前提條件

• Python 3.10 或更高版本。
• uv 包管理器。

🛠️ 開發環境設置

1. 克隆倉庫：

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

2. 安裝uv（如果尚未安裝）：

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

3. 創建虛擬環境並安裝依賴項：

uv venv
source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate
uv pip install -e ".[dev]"

4. 直接運行服務器（用於測試）：

uv run python -m npi_registry_mcp.server
# 或者使用入口點：
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(first_name="John", last_name="Smith", state="CA")

# 查找特定的NPI
search_npi_registry(npi="1234567890")

# 查找特定城市的組織
search_npi_registry(organization_name="Hospital", city="Los Angeles", state="CA")

# 按專業搜索
search_npi_registry(specialty="cardiology", state="NY", limit=20)

# 查找特定郵政編碼區域的提供者
search_npi_registry(postal_code="902*", state="CA")

高級用法

# 高級場景暫未提及，此處保留基礎用法的代碼示例
search_npi_registry(first_name="John", last_name="Smith", 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桌面配置

要在Claude桌面應用中使用此MCP服務器，請將以下配置添加到Claude桌面配置文件中：

🍎 macOS

位置：~/Library/Application Support/Claude/claude_desktop_config.json

🪟 Windows

位置：%APPDATA%/Claude/claude_desktop_config.json

📝 配置

{
  "mcpServers": {
    "npi-registry": {
      "command": "uv", # 可能需要可執行文件的完整路徑
      "args": [
        "--directory",
        "/path/to/npi-registry-mcp-server",
        "run",
        "npi-registry-mcp-server"
      ]
    }
  }
}

✅ 驗證

1. 保存配置文件。
2. 完全重啟Claude桌面應用。
3. 在Claude桌面應用中查找🔧圖標，以驗證服務器是否已連接。
4. 嘗試向Claude提問：“搜索加利福尼亞州名為Smith的醫生”。

👨‍💻 開發

📁 項目結構

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

🧪 運行測試

uv run pytest

🎨 代碼格式化

# 格式化代碼
uv run black src/ tests/

# 排序導入
uv run isort src/ tests/

# 代碼檢查
uv run ruff check src/ tests/

# 類型檢查
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）
• 美國衛生與公眾服務部

🤝 貢獻

1. 分叉倉庫。
2. 創建功能分支：git checkout -b feature-name。
3. 進行更改並添加測試。
4. 運行測試套件：uv run pytest。
5. 格式化代碼：uv run black src/ tests/。
6. 提交拉取請求。

📄 許可證

本項目採用MIT許可證，詳情請參閱LICENSE文件。

🆘 支持

• 問題反饋：通過GitHub Issues報告錯誤和請求功能。
• 文檔：/docs目錄中提供了額外的文檔。
• API問題：請參考官方NPI註冊庫API文檔。

📝 變更日誌

v0.1.0 🎉

• 初始版本發佈。
• 基本的NPI註冊庫搜索功能。
• 支持個體和組織搜索。
• 位置和專業過濾。
• 全面的提供者數據檢索。

有關模型上下文協議的更多信息，請訪問：https://modelcontextprotocol.io/