内容
# 美国医疗服务提供者信息 — MCP 服务器 & SDK（xcircl）
**经过验证的美国监管医疗服务提供者数据，适用于您的应用程序或人工智能。来源链接，带有时间戳。**
[](./LICENSE)
[](https://www.npmjs.com/package/@xcircl/sdk)
[](https://www.npmjs.com/package/@xcircl/mcp-server)
[](https://xcircl.com/data/coverage/)
[](https://xcircl.com/data/coverage/)
[](https://xcircl.com/data/coverage/)
[](https://xcircl.com/data/coverage/)
**适用于人工智能代理、诊所查找器和尽职调查团队的合规感知 GLP-1 提供商数据 API** — 查询美国受监管的医疗服务提供商（GLP-1 / 体重管理诊所今日；更多垂直领域即将推出），使用自然语言或函数调用，作为 **MCP 服务器**，适用于 Claude/ChatGPT 或 **TypeScript SDK**，适用于您自己的产品。免费层级适用于 **无需 API 密钥**；验证合规信号和现金价格需解锁。
> 上方徽章中的计数是实时从 [`/api/v1/coverage/`](https://xcircl.com/api/v1/coverage/) 拉取的 — 数字会随着数据集的增长而更新。
## 30 秒快速入门（无需密钥，无需安装）
```bash
curl -sL "https://xcircl.com/api/v1/providers/?vertical=glp1&state=TX&limit=3"
```
```jsonc
{
"tier": "free",
"notice": "Free tier: identity fields only. Verified compliance signals, price and timestamps require a key — see /developers/pricing/.",
"pagination": { "total": 15, "limit": 3, "offset": 0, "returned": 3 },
"data": [
{
"entity_id": "ent_f47550b79f755d70b58b183a",
"slug": "alegro-health-mckinney-tx",
"vertical": "glp1",
"name": "Alegro Health",
"city": "McKinney",
"state": "TX",
"business_mode": "online",
"latitude": 33.198119,
"longitude": -96.708802,
"npi": "1053066357"
}
// …
]
}
```
真实数据，真实 API，零设置。`完整字段（cash_price，compliance）从 $99/mo 自助服务 → [xcircl.com/developers](https://xcircl.com/developers/pricing/)`
## 从 Claude 使用（MCP 服务器）
无需克隆，无需构建 — `npx` 从 npm 拉取 [`@xcircl/mcp-server`](https://www.npmjs.com/package/@xcircl/mcp-server)。
**Claude 代码：**
```bash
claude mcp add xcircl -- npx -y @xcircl/mcp-server
# 使用密钥（解锁价格 + 合规字段）：
claude mcp add xcircl -e XCIRCL_API_KEY=your-key -- npx -y @xcircl/mcp-server
```
**Claude 桌面版（`claude_desktop_config.json`）：**
```json
{
"mcpServers": {
"xcircl": {
"command": "npx",
"args": ["-y", "@xcircl/mcp-server"],
"env": { "XCIRCL_API_KEY": "可选 — 免费层级省略" }
}
}
}
```
然后直接询问：*“在休斯顿查找 GLP-1 诊所并检查其合规性。”*
服务器公开三个工具：
| 工具 | 功能 |
|---|---|
| `search_providers` | 按垂直领域 / 城市 / 状态 / 商业模式筛选 |
| `get_provider` | 按 `entity_id` 或 slug 获取完整记录 |
| `check_compliance` | LegitScript / 状态许可 / FDA 信号（付费字段 — 工具仍会回答，无需密钥，并说明如何解锁） |
## 从您的代码使用（TypeScript SDK）
```bash
npm install @xcircl/sdk
```
```ts
import { XcirclClient } from '@xcircl/sdk';
const xcircl = new XcirclClient(); // 无密钥 → 免费层级
// const xcircl = new XcirclClient({ apiKey: process.env.XCIRCL_API_KEY });
const { data, notice } = await xcircl.searchProviders({
vertical: 'glp1',
city: 'Houston',
state: 'TX',
});
for (const p of data) console.log(p.name, p.city, p.npi);
if (notice) console.log(notice); // 密钥将添加的内容
```
可运行的示例位于仓库中（克隆它来运行它们；两者都无需密钥）：
```bash
git clone https://github.com/xcircl/healthcare-provider-mcp.git
cd healthcare-provider-mcp && npm install && npm run build
node examples/01-find-clinics.mjs Houston TX # 查找诊所
node examples/02-ai-tool-use.mjs # 为 Claude 提供实时 xcircl 工具（自带 ANTHROPIC_API_KEY）
```
## 数据来源
每个记录都从官方、可引用的来源组装而成 — 每个付费信号都带有其 **来源和验证时间戳**：
- **[NPPES](https://npiregistry.cms.hhs.gov/)** — CMS 国家提供者标识符注册表，用于提供者身份（名称、位置、NPI）。
- **[FDA 数据仪表盘](https://datadashboard.fda.gov/)** — 药物/生物制剂警告信筛选（2019 年以来的合规行动）。
- **州许可委员会** — 医疗和药店许可记录。
- **[LegitScript](https://www.legitscript.com/)** — 认证状态检查。
- **提供者网站** — 公布的现金价格，记录了来源页面和检查日期。
此仓库包含 **无数据文件** — 它是 xcircl API 周围的开源 shell（MCP 服务器 + SDK + 文档）。数据存在，字段分层在服务器端强制执行。唯一的演示数据来源是实时 [`/api/v1/sample/`](https://xcircl.com/api/v1/sample/) 端点（~50 条干净记录在付费模式中）。
## 免费 vs 付费字段
| 字段 | 免费（无密钥 / 免费密钥） | 构建者+（$99/mo 及以上） |
|---|:---:|:---:|
| `entity_id`, `slug`, `vertical`, `name` | ✅ | ✅ |
| `city`, `state`, `latitude`, `longitude` | ✅ | ✅ |
| `business_mode`, `npi` | ✅ | ✅ |
| `legitscript` — 认证信号 | — | ✅ |
| `license` — 状态许可记录 | — | ✅ |
| `fda` — 警告信筛选 | — | ✅ |
| `price` — 公布的现金价格 | — | ✅ |
| 每个信号的来源 + `verified_at` | — | ✅ |
## 计划
| 计划 | 价格 | 字段 | 请求 | 垂直领域 |
|---|---|---|---|---|
| **免费** | $0（在 [xcircl.com/developers](https://xcircl.com/developers/pricing/) 注册） | 身份字段 | 1,000/月 | 所有 |
| **构建者** | **$99/月** — 信用卡自助服务 | **所有字段** | 5,000/月 | 1（密钥绑定） |
| **开发者** | $750/月 · 创始客户（前 10 名）：$375/月，锁定 12 个月 | 所有字段 | 25,000/月 | 多个 |
| **企业** | [联系销售](https://xcircl.com/developers/pricing/) | 所有字段 + 导出 | 无限 | 所有 |
- **无密钥**：完全可用，100% 真实数据，以及关于付费字段的一行通知 — 免费体验是真实演示，您遇到的障碍是字段/垂直领域/数量障碍，而不是“无法运行”的障碍。
- 速率限制和垂直领域绑定由密钥在服务器端强制执行，与字段分层相同 — 此客户端不包含零个门控逻辑。
完整字段字典：[docs/schema.md](./docs/schema.md) · 生产环境中记录的测试运行：[docs/verification.md](./docs/verification.md)。
## 仓库布局
```
packages/mcp-server/ MCP 服务器（stdio）— search_providers / get_provider / check_compliance
packages/sdk-ts/ @xcircl/sdk — 零依赖 TypeScript 客户端
examples/ 可运行示例（查找诊所，AI 工具使用）
docs/schema.md 字段字典（免费/付费分层）
```
## 许可证
[MIT](./LICENSE) — shell 是开放的；在此基础上自由构建。
