使用说明
MCP提供商搜索
一个MCP服务器，用于通过地理邻近查询搜索940多万美国医疗保健提供者。专为保险诉讼研究而设计——在半径内按专业查找提供者，评估网络充足性，并交叉参考医疗保险注册状态。
特性
- 940万+供应商 来自NPPES NPI注册表（每月更新）
- PostGIS邻近查询 --查找任何邮政编码X英里范围内的提供商
- 专业搜索 通过879个NUCC分类代码
- 网络充分性分析 --提供商按15/30/60英里级别计数
- 医疗保险登记 交叉引用（250万条PECOS记录）
- 选择退出跟踪 （5.4万名选择退出联邦医疗保险的医疗服务提供者）
- MCP协议 Claude.ai和其他MCP客户端的端点
- REST API 与Swagger文档
MCP工具
| 工具 | 说明 |
|---|---|
provider_search |
按姓名、专业、州、邮政编码或NPI搜索 |
provider_nearby |
查找邮政编码X英里范围内的提供商 |
network_adequacy |
统计15/30/60英里级别的专业提供商 |
provider_detail |
完整的NPI记录，包括分类和注册状态 |
taxonomy_search |
查找NUCC专业代码 |
快速开始
通过MCP（Claude.ai）连接
在Claude.ai中添加为连接器：
- 网址：
https://providers.wyldfyre.ai/mcp - 身份验证： 无需提供
REST API
# Health check
curl https://providers.wyldfyre.ai/health
# Search providers
curl "https://providers.wyldfyre.ai/providers/search?q=smith&specialty=cardiology&state=CO"
# Find nearby providers
curl "https://providers.wyldfyre.ai/providers/nearby?zip=80202&miles=30&specialty=psychiatry"
# Network adequacy analysis
curl "https://providers.wyldfyre.ai/providers/network-adequacy?zip=80202&specialty=psychiatry"
# Provider detail
curl "https://providers.wyldfyre.ai/providers/1234567890"
# Taxonomy search
curl "https://providers.wyldfyre.ai/taxonomy/search?q=mental+health"
完整的Swagger文档：https://providers.wyldfyre.ai/docs
自我寄宿
先决条件
- Python 3.12+
- PostgreSQL 16与PostGIS 3.4
- ~15GB磁盘用于NPPES数据
设置
# Install dependencies
pip install -r requirements.txt
# Set database URL
export DATABASE_URL="postgresql://user:pass@localhost:5432/providers"
# Create database with PostGIS
psql -c "CREATE DATABASE providers;"
psql -d providers -c "CREATE EXTENSION postgis; CREATE EXTENSION pg_trgm;"
# Download and load NPPES data (~20 min)
cd data && curl -O "https://download.cms.gov/nppes/NPPES_Data_Dissemination_March_2026_V2.zip"
cd .. && python scripts/load_nppes.py data/NPPES_Data_Dissemination_March_2026_V2.zip
# Load PECOS enrollment and Opt-Out data
python scripts/load_pecos_optout.py
# Start REST API
uvicorn app.main:app --host 0.0.0.0 --port 8100
# Start MCP server (separate process)
python run_mcp.py
数据源
所有数据均来自免费、公开可用的美国政府API：
| 来源 | 记录 | 授权 | 更新频率 |
|---|---|---|---|
| NPPES NPI注册表 | 940万供应商 | 无 | 每月全额，每周增量 |
| NUCC分类学 | 879个代码 | 无 | 每年两次 |
| PECOS注册 | 250万条记录 | 无 | 季度 |
| CMS选择退出列表 | 54K条记录 | 无 | 每月 |
| ZCTA质心普查 | 33K邮政编码 | 无 | 每年 |
建筑学
┌─────────────────────┐
│ Claude.ai / MCP │
│ Clients │
└────────┬────────────┘
│ MCP Protocol
┌────────▼────────────┐
│ providers.wyldfyre │
│ .ai/mcp │
└────────┬────────────┘
│
┌──────────────┼──────────────┐
│ │ │
┌─────────▼───┐ ┌──────▼─────┐ ┌─────▼──────┐
│ PostgreSQL │ │ FastAPI │ │ MCP Server │
│ + PostGIS │ │ REST API │ │ (FastMCP) │
│ (9.4M rows) │ │ :8100 │ │ :8101 │
└─────────────┘ └────────────┘ └────────────┘
许可证
麻省理工学院
