MyMedi-AI

@mymedi-ai/mcp-server

用于 DME 账单和医疗编码的 MCP 服务。将 Claude、Cursor、VS Code 或任何 MCP 客户端连接到 32 个工具 — 可跨包含 9 万多个 ICD-10-CM、CPT 和 HCPCS 编码的数据库查找代码，查询 DMEPOS 费用表，检查 Medicare 事先授权和面对面清单，获取拒赔代码指南并进行提交前索赔检查 — 另有五个 DME 账单提示词和三个数据集资源。六个工具无需 API 密钥即可使用。

从设计上杜绝 PHI：这些工具接受代码、修饰符、服务日期和去标识化文本，绝不接受患者身份标识。除为付费调用扣除额度外，没有任何工具会更改任何内容；唯一例外是 buy_credits，它会打开 Stripe 结账会话（在浏览器中完成结账前不会扣款）。

**Claude（网页或桌面版）用户：**使用 Free、Pro 和 Max 计划时，打开 Customize → Connectors → + Add → Add custom connector，为其命名并输入 URL https://mymedi-ai.com/mcp-stream，然后选择 Add → Connect。使用 Team 和 Enterprise 计划时，Owner 在 Organization settings → Connectors → Add → Custom → Web 下添加一次，之后成员即可在 Customize → Connectors 中选择 Connect。该端点受 OAuth 保护：Claude 会自行注册，并提示你登录 MyMedi-AI 一次；首次连接器登录会附赠免费入门额度。无需复制 API 密钥。

快速开始

需要 Node.js 20 或更高版本。

安装

claude mcp add mymedi-ai --env MCP_API_KEY=your-api-key -- npx -y @mymedi-ai/mcp-server

省略 --env MCP_API_KEY=… 即可使用六个免费工具启动。其他客户端请参阅客户端配置。

获取 API 密钥（用于付费工具）

注册需要发送 POST 请求，而非访问网页：

curl -X POST https://mymedi-ai.com/bot-marketplace/register \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'
# → { "apiKey": "...", "credits": ..., "quickStart": { ... } }

将返回的 apiKey 设置为 MCP_API_KEY。（注册响应中显示的名称 MYMEDI_API_KEY 也可使用；如果两者都已设置，则优先使用 MCP_API_KEY。）新密钥会附赠免费入门额度；使用 buy_credits 工具可以添加更多额度。

或试用免费端点

curl "https://mymedi-ai.com/agent/v1/demo?code=99213"

返回基本代码元数据，每个 IP 每小时最多 60 次请求。

免费工具（无需 API 密钥）

安装服务时不设置 MCP_API_KEY，即可立即使用以下工具（每个 IP 每小时最多 60 次请求）：

工具	功能
pa_required_check	检查某个 HCPCS 代码在指定服务日期是否列入 CMS Required Prior Authorization List (42 CFR 414.234)；按州分阶段纳入的项目
denial_code_info	DME 拒赔代码（CARC）说明 — 含义、常见原因、解决办法和是否可申诉
code_lookup_basic	基本代码元数据 — 代码、类型、描述、类别、启用状态
reimbursement_basic	Medicare 全国 PFS 付款金额和 DMEPOS 费用表范围（租赁/购买）
order_readiness_checklist	空白 DMEPOS 交付前检查清单 — SWO 要素、F2F/WOPD、事先授权 (42 CFR 410.38)
modifier_advisor	DMEPOS 账单修饰符指南 — KX/GA/GY/GZ、RR/NU/UE、租赁月数上限、左右侧

其余 26 个工具需要 API 密钥（或连接器登录）：其中 24 个为付费工具 — 按次收费，或对 code_lookup_batch、code_validate_batch 和 pa_exposure_report 按代码收费；account_status 和 buy_credits 免费，但需要密钥来识别账户。

客户端配置

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "mymedi-ai": {
      "command": "npx",
      "args": ["-y", "@mymedi-ai/mcp-server"],
      "env": {
        "MCP_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "mymedi-ai": {
      "command": "npx",
      "args": ["-y", "@mymedi-ai/mcp-server"],
      "env": { "MCP_API_KEY": "your-api-key" }
    }
  }
}

VS Code

添加到 .vscode/mcp.json：

{
  "servers": {
    "mymedi-ai": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@mymedi-ai/mcp-server"],
      "env": { "MCP_API_KEY": "your-api-key" }
    }
  }
}

Claude Code

claude mcp add mymedi-ai --env MCP_API_KEY=your-api-key -- npx -y @mymedi-ai/mcp-server

工具（32 个）

免费（无需 API 密钥）

工具	描述	价格
pa_required_check	Medicare DMEPOS 是否需要事先授权的检查（42 CFR 414.234）	免费
denial_code_info	DME 拒付代码（CARC）说明	免费
code_lookup_basic	基本代码元数据查询	免费
reimbursement_basic	Medicare 全国 PFS 支付额及 DMEPOS 费用表范围	免费
order_readiness_checklist	空白 DMEPOS 交付前检查清单（SWO、F2F/WOPD、PA）	免费
modifier_advisor	DMEPOS 账单修饰符指南（KX/GA/GY/GZ、RR/NU/UE、左右侧）	免费

账户（免费——使用您的登录信息或 API 密钥）

工具	描述	价格
account_status	额度余额、使用情况和近期交易	免费
buy_credits	返回用于添加额度的 Stripe 结账链接；本身不会收取任何费用	免费

医疗编码

工具	描述	价格
code_lookup	查询 ICD-10、CPT 或 HCPCS 代码；标注 DMEPOS 费用表，可选指定州	$0.001
code_lookup_batch	每次调用最多查询 25 个代码，逐项返回结果；所有代码均无匹配时退款	$0.001/代码
code_suggest	根据临床描述提供代码建议（术语搜索、覆盖范围排序；无匹配时退款）	$0.01
code_validate	检查代码是否有效且仍在使用，可选指定服务日期	$0.005
code_validate_batch	每次调用最多查询 25 个代码，逐项返回结果	$0.005/代码
code_crossref	查询 ICD-10、CPT 和 HCPCS 中的相关代码	$0.02
code_reimbursement	Medicare PFS 费率：RVU 和预估支付额	$0.01
fee_schedule_lookup	DMEPOS 费用表——按州查询租赁/购买、农村/非农村费率	$0.01

事先授权和理赔

工具	描述	价格
pa_predict	根据您所在机构已裁定的事先授权申请（10 个或以上）预测批准率；否则返回 CMS 列表事实，结果退款——绝不编造概率	$0.05
pa_status	查询在 MyMedi-AI 网页工作区中跟踪的事先授权申请状态（不会查询付款方）	$0.02
pa_exposure_report	按服务日期将最多 100 个 HCPCS 代码与 CMS 的事先授权及 F2F/WOPD 列表进行比对，并标出文档要求和拒付风险；对于按州分阶段实施的项目，请传入州名	$0.01/代码
claims_validate	提交前检查理赔代码和服务日期；不评估医疗必要性或事先授权	$0.05
ner_extract	从去标识化文本中提取 ICD-10-CM、HCPCS Level II（含修饰符）和带关键词标记的 CPT 代码，并逐一对照代码集检查；同时提取 M/D/Y 日期并标记剂量单位；不包含药品名称	$0.02
compliance_audit	根据真/假事实审核一份 DMEPOS 订单的文档（SWO 要素、F2F/WOPD、事先授权），依据其 HCPCS 代码和服务日期进行检查——绝不使用身份标识信息；逐项返回通过或未通过及相应引文，任一要求未通过时整体结果即为未通过	$0.25

药品数据

工具	描述	价格
drug_lookup	OpenFDA 药品标签和不良事件数据	$0.01
drug_interactions	FAERS 中同时提及这些药品的报告，提供各项反应的比例报告比（PRR）和 95% 区间，并与单独使用每种药品进行比较——这是统计关联，并非药物相互作用的证据	$0.03
drug_rxnorm	使用 NIH RxNorm 规范化药品名称（RxCUI、术语类型）	$0.02
drug_enrich	首个匹配的 openFDA 药品标签，以及带标签的大模型摘要（类别、用途、替代方案）；不检查药物相互作用，也不判定事先授权、覆盖范围或费用	$0.03

服务提供者与市场

工具	描述	价格
provider_search	按姓名、专科或地点搜索 NPI 注册库（NPPES）	$0.005
provider_enrich	查询 NPI 对应的 NPPES 记录，并提供带标签的大模型估算，包括专科需求、网络缺口和转诊类别	$0.05
provider_payments	查询向医生支付的行业款项（CMS Open Payments）	$0.02
market_analysis	查询某专科和州的 NPPES 服务提供者数量（仅作下限；单次查询最多返回 200 条），并提供带标签的大模型需求和机会估算	$0.10

临床与公共卫生

工具	描述	价格
trials_search	临床试验（ClinicalTrials.gov）	$0.03
disease_surveillance	法定传染病病例数（CDC NNDSS）	$0.02

提示词

提示词	参数	功能
decode-denial	code（CARC，例如 CO-50）	使用 denial_code_info 解读拒付代码，然后制定修正、重新提交或申诉的行动计划
order-readiness	code（HCPCS，例如 E0466）	使用 order_readiness_checklist 汇总交付前所需的空白文件清单
scrub-claim	procedureCodes、diagnosisCodes?、dateOfService?	使用 claims_validate 检查代码和服务日期，并通过免费工具检查 PA 与 F2F/WOPD 清单，然后提供按优先级排列的修正清单；若缺少诊断代码或日期，会询问补充信息，但绝不询问患者身份信息
draft-appeal	code（CARC）、procedureCode?	解读拒付，并列出重新裁定信的要点及随附文件
estimate-reimbursement	code（HCPCS）、state?	查询 fee_schedule_lookup，并说明租赁与购买、农村与非农村地区的区别

资源

资源	URI	内容
PA 所需清单	mymedi://datasets/pa-required-list	CMS 必需事先授权清单（42 CFR 414.234），包含类别及全国实施日期
F2F + WOPD 清单	mymedi://datasets/f2f-wopd-list	CMS 面对面评估／交付前书面医嘱清单（42 CFR 410.38(d)），以及标准书面医嘱要素
平台概览	https://mymedi-ai.com/llms.txt	MyMedi-AI 的介绍、工具目录、定价和集成方式（从公开网站读取；若无法访问，则提供简短摘要）

额度与计费

• 每种工具的价格清单以 JSON 格式发布于 https://mymedi-ai.com/bot-marketplace/credits/pricing。
• 1 个额度 = $0.001。付费工具每次调用费用从 1 个额度（code_lookup）到 250 个额度（compliance_audit）不等；code_lookup_batch、code_validate_batch 和 pa_exposure_report 按代码计价。调用失败会退还费用。
• 每次成功的付费调用，其结果都包含 _billing 字段：{ "creditsSpent": …, "creditsRemaining": …, "priceUSD": … }。（通过普通 REST（不使用 MCP）调用时，相同信息会通过 X-Credits-Spent / X-Credits-Remaining 标头返回。）
• account_status 会显示余额和近期交易记录。buy_credits 会返回 Stripe 结账链接——$1 可购买 1,000 个额度，套餐价格从 $1 到 $500 不等；完成结账后即可获得额度。

环境变量

变量	描述	默认值
MCP_API_KEY	注册时获取的 API 密钥；省略此项则只能使用免费工具	—
MYMEDI_API_KEY	MCP_API_KEY 的可接受别名（两者都设置时以 MCP_API_KEY 为准）	—
MCP_API_BASE_URL	API 基础 URL	https://mymedi-ai.com
MCP_CONNECTOR_TOKEN	用于托管式多用户部署的共享出口速率限制令牌（个人安装无需设置）	—
MCP_HTTP	设置为 1 时运行 HTTP 模式，等同于 --http	—
MCP_HOST	HTTP 模式监听的地址	127.0.0.1
MCP_PORT	HTTP 模式的端口	8080
MCP_HTTP_TOKEN	客户端调用 HTTP 模式时必须发送的 Bearer 令牌；当 MCP_HOST 不是回环地址时为必填项；至少 32 个字符	—
MCP_ALLOWED_HOSTS	客户端用于访问 HTTP 模式的主机名或地址（以逗号分隔）；使用 MCP_HOST=0.0.0.0 时，需包含局域网或 Docker 主机的 IP 地址	—
MCP_ALLOWED_ORIGINS	允许调用 HTTP 模式的浏览器来源（以逗号分隔，例如 https://app.example.com）	无
MCP_MAX_SESSIONS	HTTP 会话的最大数量	100
MCP_SESSION_IDLE_MS	HTTP 会话闲置达到此时长后将关闭	1800000（30 分钟）

HTTP 模式（--http）

同一服务也可以通过 Streamable HTTP 运行，供通过 URL 连接的客户端使用：

MCP_API_KEY=your-api-key npx -y @mymedi-ai/mcp-server --http
# MCP HTTP server listening on http://127.0.0.1:8080/mcp

所有通过此模式发出的调用都会使用 MCP_API_KEY 中的密钥，因此此端点受到保护：

• 默认使用回环地址。 除非另行设置 MCP_HOST，否则服务会监听 127.0.0.1。
• 非回环地址必须设置令牌。 使用非回环的 MCP_HOST（例如 0.0.0.0）时，除非设置了 MCP_HTTP_TOKEN，否则服务会拒绝启动；令牌至少需要 32 个字符，例如 openssl rand -hex 32。客户端随后需发送 Authorization: Bearer <token>；其他请求都会收到 401 响应。回环地址也可以设置令牌。
• 主机检查。 请求必须将服务指定为 localhost、127.0.0.1、[::1]、MCP_HOST 中的地址，或 MCP_ALLOWED_HOSTS 中的主机名或地址；其他 Host 值都会收到 403 响应。这可以阻止 DNS 重绑定页面。使用 MCP_HOST=0.0.0.0 时，服务没有可供匹配的自身地址，因此需在 MCP_ALLOWED_HOSTS 中列出客户端使用的所有地址，包括局域网 IP、Docker 主机 IP 和 DNS 名称。
• 来源检查。 来自网页的请求（带有 Origin 标头）只有在该来源位于 MCP_ALLOWED_ORIGINS 中时才会被接受，否则会收到 403 响应；只有列出的来源才会收到 CORS 标头。桌面客户端不会发送 Origin，因此不受影响。
• 限制。 大于 1 MiB 的请求正文会收到 413 响应；非 JSON 正文会导致 JSON-RPC 解析错误；会话数量受限（MCP_MAX_SESSIONS），且闲置达到 MCP_SESSION_IDLE_MS 后会关闭；未知会话 ID 会收到 404 响应，客户端随后会启动新会话。

供其他机器访问：

MCP_HOST=0.0.0.0 MCP_HTTP_TOKEN="$(openssl rand -hex 32)" MCP_ALLOWED_HOSTS=mcp.example.com,192.168.1.20 \
  MCP_API_KEY=your-api-key npx -y @mymedi-ai/mcp-server --http

流量离开本机时，请在服务前配置 TLS（反向代理）：令牌会通过标头传输。

1.7.8 版本变更

无需更改配置，但请更新为使用 compliance_audit：它现在需要传入订单，而 API 会拒绝 1.7.7 及更早版本发送的自由格式载荷（返回 400，且不收费）。

现在有 3 个付费工具会按描述执行操作。compliance_audit 会根据真实/虚假事实审核一份 DMEPOS 订单的文档——包括标准书面订单要素、交付前的面对面诊疗和书面订单，以及事先授权——并针对订单的 HCPCS 代码和服务日期（现在为必填项）进行审核；这些事实绝不包含标识符。每项要求都会返回通过或未通过及其引用来源；只要有一项未通过，结果就会判定为未通过。它不再运行过去使用的标识符模式检查；auditType 为可选项，且只能取 dme_order。drug_interactions 会返回同时提及这些药物的 FAERS 报告数量，并针对每种反应，给出与单独使用每种药物相比的比例报告比及其 95% 区间，不再按报告数量评级；药名会规范化为 openFDA 可搜索的形式（包括重音符号、弯引号、® 和 ™、“+”和“&”，以及 0.5% 或 1:100,000 等规格），少于 2 个字母或数字，或包含引号或其他符号的名称将被拒绝。ner_extract 会识别完整的 ICD-10-CM 代码（含扩展码）、带修饰符的 HCPCS Level II 代码，以及仅在有关键词标示时出现的 CPT 代码，并逐一对照代码集检查；entityTypes 新增 HCPCS_CODE。

代码工具现在会对答案排序并标注日期。code_suggest 会按相关性排序：它能识别常见缩写和其他形式（CPAP、OSA、COPD、表示免疫球蛋白的 IG、type 2），以及类型、性别或 "without"；会优先为描述中提及的每个不同事项分别列出最佳代码，并省略较弱匹配项，而不是凑满列表。code_crossref 会返回精选的 linkedCodes（DME 代码系列，以及引用其 CMS 来源的跨代码系统链接）和按 relevanceScore 排序的 crossReferences，并省略较弱匹配项；没有相关代码的答案会退款。code_validate 和 code_validate_batch 可在顶层以及 context 中接收 dateOfService（或 date_of_service）；如果日期格式不是 YYYY-MM-DD，或两个日期不一致，则会拒绝请求，并返回 asOf，即代码判定所依据的日期。claims_validate 会说明其检查内容——服务日期当天有效的代码、格式正确的修饰符，以及非未来日期——并注明它不会应用 NCCI 编辑。

1.7.7 版本变更

无需更改配置。工具描述现在与 API 的返回内容一致：drug_enrich 会列出其返回的标签字段和带标签的大模型摘要，并说明调用失败时会退款（API 不再返回模型生成的事先授权可能性或成本等级）；pa_predict 会说明其批准率仅根据贵组织自行决定的事先授权计算，且 payerId 表示付款方类别；ner_extract 会列出其匹配的模式（不会提取药名），并且现在会应用其 entityTypes 筛选条件；code_suggest 最多接收 500 个字符（搜索此前不会读取更多字符；现在会拒绝更长的文本，而不再静默截断）；数据来源会列出，但不再声称其许可信息。支持邮箱为 [email protected]。

升级到 1.7.6

仅影响远程 --http 部署，且会带来不兼容变更。 在 1.7.5 及之前的版本中，HTTP 模式会监听所有网络接口，不带令牌也会为任何调用方提供服务，并发送 Access-Control-Allow-Origin: *。从 1.7.6 开始，它会监听 127.0.0.1；如需为其他机器提供服务，请设置 MCP_HOST、MCP_HTTP_TOKEN（非环回地址必需）以及 MCP_ALLOWED_HOSTS，其中应包含客户端使用的所有主机名或地址（设置 MCP_HOST=0.0.0.0 时，还需包含局域网和 Docker 主机的 IP）；基于浏览器的客户端还需要 MCP_ALLOWED_ORIGINS。现在，未知会话 ID 会返回 404，而不是 400。stdio 安装（Claude Desktop、Cursor、VS Code、Claude Code）不受影响。

1.7.6 还要求使用 Node.js 20 或更高版本（Node 18 已结束生命周期，且 SDK 的依赖项需要 20）。1.7.6 中的其他变更：服务会在初始化时发送其说明；scrub-claim 接受可选的 dateOfService，且不再询问医疗必要性；MYMEDI_API_KEY 可作为 MCP_API_KEY 的别名；未提供密钥时，付费调用会说明如何注册。

SDK

如需在不使用 MCP 的情况下以编程方式调用，请安装 SDK：

npm install @mymedi-ai/sdk

import { MyMediAI } from '@mymedi-ai/sdk';

const client = new MyMediAI({ apiKey: 'your-api-key' });
const result = await client.codeLookup('M79.3');

数据来源

• ICD-10-CM 和 HCPCS Level II：CMS 和 CDC 代码集
• CPT®：来自 CMS 医师费用表（RVU）文件。CPT® 是 American Medical Association（AMA）的注册商标；CPT 代码和描述的版权归 AMA 所有。
• 费用表和列表：CMS DMEPOS 费用表、Medicare 医师费用表（RVU）、Required Prior Authorization List 和 F2F/WOPD list
• 提供者：CMS NPI registry（NPPES）和 CMS Open Payments
• 药物：openFDA（标签、不良事件）和 NIH RxNorm
• 临床和公共卫生：ClinicalTrials.gov 和 CDC NNDSS

故障排除

• 402 "payment_required" — 未提供 API 密钥时，付费工具会返回要发送的注册申请（参见获取付费工具的 API 密钥）；提供了密钥时，这表示额度已用完：调用 buy_credits。六个免费工具始终无需密钥。
• "invalid_api_key" — MCP_API_KEY（或 MYMEDI_API_KEY）中的密钥无法识别：检查是否有拼写错误或遗漏部分，然后重启服务，或注册新密钥。
• 免费工具返回 429 — 免费端点每个 IP 每小时允许 60 次请求。请稍后再试，或使用密钥调用付费等效工具。
• 连接器无法连接 — 托管端点为 https://mymedi-ai.com/mcp-stream（Streamable HTTP），并受 OAuth 保护。未经身份验证的请求会返回 {"error":"unauthorized","error_description":"OAuth required"}——这表示端点正常工作，并非故障；裸运行 inspector --cli … --method tools/list 会显示此错误，因为它没有令牌。若要确认服务已启动，请读取发现文档：curl -s https://mymedi-ai.com/.well-known/oauth-protected-resource 会将 .../mcp-stream 列为受保护资源。Claude 会执行动态客户端注册和登录。
• --http 返回 401、403 或拒绝启动 — 请参阅 HTTP 模式：发送 bearer 令牌，将主机名添加到 MCP_ALLOWED_HOSTS，或将 Web 来源添加到 MCP_ALLOWED_ORIGINS，并在监听非环回地址前设置 MCP_HTTP_TOKEN。
• 未找到代码 — 查询应使用不带修饰的代码（E1390、99213、M79.3）。拒付代码可使用 CO-50、co50 或 50。
• 数据时效性 — 参考数据遵循 CMS 发布周期；事先授权和 F2F/WOPD 查询结果会注明所依据的列表版本。
• 仍无法解决？ 请发送邮件至 [email protected]，或在 https://github.com/MyMedi-AI/mymedi-ai-mcp-server/issues 提交问题。

链接

• API 发现（JSON）
• 免费演示查询
• 价格列表（JSON）
• 网页或连接器账户的积分
• API 密钥注册：POST https://mymedi-ai.com/bot-marketplace/register（这是一个请求，而非页面）
• 托管连接器：https://mymedi-ai.com/mcp-stream

许可证

MIT