
validar-codigo-medico
io.github.encodi由 GitHub 账号 encodi 发布v1.0.1更新于 Oct 25, 2026
Validates ICD-10-CM against the real FY2026 catalog (NCHS/CDC) and CPT by structure/category.
概览
远程 MCP 服务器,让助手按官方 FY2026 目录校验 ICD-10-CM 编码,并检查 CPT 编码结构。
- 可以做什么
- 校验医疗编码:将 ICD-10-CM 编码与内置的 FY2026 NCHS/CDC 可计费目录比对并返回官方简短描述,或检查 CPT 编码的结构与类别(I、II、III 类)并按数字区间估算所属领域。每次调用无状态,调用之间没有数据库或持久化数据。
- 适用场景
- 适合助手需要确认诊断或操作编码格式是否正确、是否存在于官方 ICD-10-CM 目录中的场景,例如起草或审阅临床与计费文本时。它不能替代持证专业编码员。
- 运行要求
- 通过 streamable HTTP 连接的远程端点;未声明需要本地运行时、账户或 API 密钥。每次调用均计费,客户端需能在 Base 主网上完成 x402 的 USDC 支付并重试。
安装
在 SourceWeft 中
- 打开 控制台中的 validar-codigo-medico,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
交给智能体安装
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/io.github.encodi%2Fvalidar-codigo-medico/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。其他 MCP 客户端
把它添加到你客户端的 mcpServers 配置中。
{
"mcpServers": {
"validar-codigo-medico": {
"type": "http",
"url": "https://validar-codigo-medico.encodari.workers.dev/mcp"
}
}
}README
validar-codigo-medico
[validar-codigo-medico MCP server]
Remote MCP server (Cloudflare Workers) with one tool that validates medical codes against real data:
validate_medical_code—system: "icd10"does a real lookup against the official billable ICD-10-CM code catalog (FY2026, NCHS/CDC, public domain as a work of the U.S. government) and returns the official short description.system: "cpt"validates the real structure of a CPT code (Category I: 5 digits; Category II: 4 digits +F; Category III: 4 digits +T) and estimates its area by public numeric range — it doesn't include per-code descriptions, because the CPT catalog is owned by the AMA and requires a paid license (it can't be redistributed).
No database, no persistent state between calls: each call builds a fresh McpServer (see createServer() in src/index.ts). The ICD-10-CM catalog (~6MB, 74,719 codes) is bundled into the Worker itself as static data (src/tools/data/icd10cm.ts) and parsed once per isolate into an in-memory Map — see src/tools/codigoMedico.ts.
Why CPT has no descriptions
The CPT (Current Procedural Terminology) description catalog is owned by the American Medical Association and requires a paid license to redistribute its content — unlike ICD-10-CM, which is a work of the U.S. government and therefore public domain. That's why this tool validates a CPT code's real format (regex + numeric range, publicly available information about the code's structure) but doesn't offer the procedure's description: that requires an AMA-licensed codebook.
Billing (x402)
Charges per call via x402 — real USDC payment on Base mainnet, against the Coinbase Developer Platform (CDP) facilitator. The payment travels inside the MCP JSON-RPC itself (_meta), not as an HTTP header; see src/payments.ts.
An unpaid tools/call returns isError: true with the accepts (network, amount, payTo) the client needs to pay and retry — not an unexplained exception.
Structure
Updating the ICD-10-CM catalog
When NCHS publishes a new version (new fiscal year or addenda):
- Download the "Code Descriptions" zip from
https://ftp.cdc.gov/pub/health_statistics/nchs/publications/ICD10CM/<YEAR>/. - Unzip it and locate
icd10cm-codes-<YEAR>.txt. node scripts/gen-icd10-data.mjs <path-to-txt> src/tools/data/icd10cm.ts.
Running it locally
⚠️ Note on wrangler dev: the real Cloudflare Workers runtime (workerd) requires macOS 13.5+. If your Mac has an older version, wrangler dev (and npm run dev) will fail. This project includes a plain-Node shim that runs the exact same fetch() handler without needing workerd.
1. Install dependencies
2. Run the unit tests
3a. If your wrangler dev works (macOS 13.5+, Linux, Windows)
3b. If wrangler dev fails because of the macOS version
Starts at http://localhost:8787/mcp, reading CDP credentials from ~/.mcp-tools-factory-credentials.env (shared across all tools in this factory).
4. Test with curl
Responses come as Server-Sent Events (event: message + data: {...}); the data: line is the usual JSON-RPC response.
Deploy and listings
Deployed at https://validar-codigo-medico.encodari.workers.dev/mcp (Cloudflare Workers). Published on the official MCP registry, Smithery, mcp.so, and with an open PR to awesome-mcp-servers.
What it doesn't do (yet)
- Doesn't include per-code CPT descriptions (see "Why CPT has no descriptions" above).
- Charges on Base mainnet with real money. To switch back to testnet (Base Sepolia,
eip155:84532) during development, changeNETWORKinsrc/payments.ts. - No database or persistent state between calls (beyond the billing config and the ICD-10-CM catalog Map, cached in memory per isolate).
- Not medical or billing advice: this is a structural/catalog validation, not a substitute for a certified professional coder.
来源:README.md,提交 6a10b7b
工具
0版本历史
1- v1.0.1最新Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通必需25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式必需10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分