Npi Registry MCP Server

🚀 NPI Registry MCP Server 🏥

このサーバーは、米国の医療提供者や組織に関する情報を検索および取得するためのツールを提供し、National Provider Identifier (NPI) レジストリを検索するためのModel Context Protocol (MCP) サーバーです。

🚀 クイックスタート

NPIは、米国の医療提供者に付与される一意の識別番号です。このMCPサーバーを使用すると、Claudeやその他のMCP互換クライアントが、Centers for Medicare & Medicaid Services (CMS) によって管理されている公式のNPIレジストリを検索し、その結果をLLMのコンテキストに統合して、高度な分析や洞察を得ることができます。

✨ 主な機能

• 提供者名での検索：名前、姓、または両方を指定して、個々の医療提供者を検索できます。
• 組織名での検索：名前を指定して、医療組織を検索できます。
• NPI番号での検索：特定の10桁の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 🔎

様々な条件でNPIレジストリを検索します。

パラメーター：

• first_name（オプション）：提供者の名前
• last_name（オプション）：提供者の姓
• organization_name（オプション）：組織名
• npi（オプション）：特定の10桁のNPI番号
• city（オプション）：都市名
• state（オプション）：州の略称（例: 'CA', 'NY'）
• postal_code（オプション）：郵便番号（ワイルドカードをサポート）
• specialty（オプション）：提供者の専門分野または分類
• limit（オプション）：返す最大結果数（1 - 200、デフォルト: 10）

基本的な使用法

# 特定の提供者を名前で検索
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")

応答形式 📄

検索は、次のような構造化された応答を返します。

{
  "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 Desktopの設定 🖥️

このMCPサーバーをClaude Desktopで使用するには、Claude Desktopの設定ファイルに次の設定を追加します。

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 Desktopを完全に再起動します。
3. Claude Desktopの🔧アイコンを確認して、サーバーが接続されていることを確認します。
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レジストリから直接取得されます。

• Centers for Medicare & Medicaid Services (CMS)
• U.S. Department of Health and Human Services

🤝 コントリビューション

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レジストリ検索機能
• 個人および組織の検索サポート
• 地域および専門分野のフィルタリング
• 包括的な提供者データの取得

Model Context Protocolの詳細については、次のURLを参照してください: https://modelcontextprotocol.io/