WellFit 医学代码服务端 (MCP)

关键词

医学编码CPTICD-10HCPCS编码查询

使用说明：

  1. 项目简介
  • 该仓库实现了一个完整的 MCP 服务器，用于对 CPT、ICD-10、HCPCS 等医学编码进行检索、校验与辅助工具调用，并对外暴露符合 MCP 协议的 JSON-RPC 接口。
  • 服务器具备初始化握手、工具列表、工具调用等核心能力，以及对请求的鉴权、速率限制与审计日志，便于在多租户场景下对编码数据进行查询与验证。
  1. 主要功能点
  • MCP 协议核心：支持 initialize、tools/list、tools/call 等 MCP 请求路径，提供统一的 JSON-RPC 响应。
  • 编码查询工具：search_cpt、search_icd10、search_hcpcs，支持查询、筛选与分页。
  • 代码细节与校验：get_code_details、validate_code_combination、check_bundling 等工具，帮助判断代码有效性和组合关系。
  • 修改与扩展能力：支持 get_modifiers、suggest_codes、get_sdoh_codes 等扩展工具，便于临床工作流的多样化需求。
  • 审计与合规：对查询日志、工具调用等行为进行审计日志记录，支持安全、可追溯的使用环境。
  • 访问控制与速率限制：基于请求标识进行速率限制，按租户与用户进行访问控制。
  • 容错与健康检查：包含健康端点、错误处理与断言，提升稳定性。
  1. 安装步骤
  • 安装依赖并准备运行环境（步骤在仓库的具体实现中已有）
  • 启动服务：部署时需在合适的云端运行环境中启动对应的 Deno/Node 服务，确保网络可访问并具备所需的数据库/鉴权后端访问权限
  • 配置环境变量：按照部署环境设置必要的数据库连接、鉴权和监控配置

  1. 服务器配置（MCP 客户端需要的配置信息，JSON 格式，包含 server name、command、args 等注释） { "server_name": "mcp-medical-codes-server", "command": "deno", "args": [ "run", "--allow-net", "--allow-env", "--allow-read", "supabase/functions/mcp-medical-codes-server/index.ts" ], "notes": "该服务器实现了 MCP 协议的核心握手与工具调用能力，客户端通过 initialize 获取服务能力、通过 tools/list 获取可用工具、通过 tools/call 调用具体工具。实际部署时请根据运行环境调整权限与路径。" } 说明：以上为示例配置，实际部署时请按目标运行环境与容器/云服务的要求配置启动命令与参数。客户端无需额外配置信息。

  2. 基本使用方法

  • 启动并对外暴露系统接口后，客户端可通过 MCP JSON-RPC 请求与之互动：
    • 调用 initialize 获取服务器能力与版本信息
    • 调用 tools/list 获取工具清单
    • 调用 tools/call 传入 toolName 与参数，获取相应的查询结果或处理结果
  • 结合具体前端/LLM 应用，将返回的结果用于后续的编码查询、诊断支持或临床工作流。

服务器信息

访问项目