Agent Skill 核验档案

Deploying Openmed MCP

该 Skill 指导如何部署并运行 OpenMed 的 MCP（Model Context Protocol）服务器，使编码代理（Claude Code、Codex）和聊天客户端能够以工具方式调用临床 NER、PII/PHI 提取与去标识化能力，全部在本地设备（on-device）运行。它涵盖 openmed[mcp] 安装、create_mcp_server、7 个工具（openmed_analyze_text、openmed_extract_pii、openmed_deidentify、openmed_list_models、openmed_list_pii_languages、openmed_loaded_models、openmed_unload_model）、resources 与 prompts、stdio 与 streamable-http 两种传输方式、ServiceRuntime 环境变量配置、MCP 客户端配置片段以及 Docker 容器化部署。

适用任务

将 OpenMed 以 stdio 传输方式添加到 Claude Code 的 .mcp.json MCP 配置中，让代理获得 7 个临床工具
使用 streamable-http 传输在 127.0.0.1:8081 运行共享 MCP 端点，供团队或聊天客户端访问
在代理发送文本片段前调用 openmed_deidentify 工具进行去标识化处理
通过 openmed_loaded_models 与 openmed_unload_model 管理常驻模型内存
使用提供的 Dockerfile 将 MCP 服务器容器化并以 streamable-http 方式部署

输入

待分析的临床文本（text 参数）
模型名称、置信度阈值、分组/聚合策略等工具参数
去标识化方法（mask/remove/replace/hash/shift dates）、keep_year、date_shift_days、keep_mapping、lang 等参数
ServiceRuntime 环境变量：OPENMED_PROFILE、OPENMED_SERVICE_PRELOAD_MODELS、OPENMED_SERVICE_KEEP_ALIVE、OPENMED_SERVICE_MAX_RESIDENT_MODELS
CLI 标志或环境变量：--transport/{stdio,streamable-http,http}、--host、--port、--streamable-http-path

输出

临床 NER 实体分析结果（openmed_analyze_text）
PII/PHI 跨度检测结果（openmed_extract_pii）
去标识化文本，可选包含重标识映射（openmed_deidentify）
注册表模型列表、支持的 PII 语言及默认模型、常驻模型状态
resources：openmed://models、openmed://pii-languages、openmed://examples（合成示例）

限制与检查

服务器自身不内置 auth/TLS，远程共享时必须自行前置认证代理
仅在用户自运营的实例上处理真实 PHI，不应指向不由自己运营的 OpenMed MCP
keep_mapping=True 会返回重标识映射，仅对受信任代理启用且视为 PHI、不得记录日志
不得在服务器周围添加会记录原始 PHI 的 transcript/body 日志
确认代理配置的传输方式正确：编码代理使用 stdio，共享端点使用 streamable-http 并已前置 auth/TLS
验证 7 个工具（如 openmed_deidentify、openmed_analyze_text）在客户端中可见且可调用
检查 keep_mapping 仅在受信任代理中启用，且映射未被记录到日志
使用 openmed_loaded_models 确认内存中常驻模型状态，并按需 openmed_unload_model 释放

Deploying Openmed MCP

适用任务

输入

输出

限制与检查

AI 搜索

项目详情