icf-mcp

ICF MCP 服务（Cloudflare Workers）

一个用于 WHO《国际功能、残疾和健康分类》（ICF）的 模型上下文协议（MCP）服务，部署在 Cloudflare Workers 上，可在全球边缘节点提供服务。

线上 URL： https://mcp-icf.medseal.app/mcp

什么是 ICF？

ICF 是 WHO 的一套分类，与 ICD（诊断代码）互为补充，用于描述健康状况如何影响一个人在日常生活中的功能：

• 身体功能（b） - 生理和心理功能
• 身体结构（s） - 身体的解剖部位
• 活动和参与（d） - 任务执行和生活参与
• 环境因素（e） - 物理、社会和态度环境

工具

一个带有动作分发功能的 icf 工具（可节省令牌）。共有 19 个动作：

代码与层级结构

动作	描述
lookup	查询特定 ICF 代码（例如 b280、d450）
search	按关键词搜索（例如“行走困难”“疼痛”）
browse	浏览类别（b、s、d、e）或子章节（b1、d4、e3）
children	获取某个代码的子类别
parent	向上导航到代码的父类别
siblings	获取同一层级（具有相同父级）的代码
chain	获取从根节点到某个代码的完整层级路径
profile	根据多个代码构建功能概况

限定值

动作	描述
qualifier	特定组成部分的限定值参考（b=1，s=3，d=2，e=障碍/促进因素）
validate	验证代码格式和限定值，并在 WHO API 中确认代码是否存在
parse	解析完整限定代码（d450.23、s730.312、e120+3）

临床评估工具

11 种标准化 RPM 工具，包含条目、评分和 ICF 映射： GAD-7、PHQ-9、RADAI-5、SLEDAI-2K、WHODAS 2.0、HAQ-DI、PROMIS-10、CAT、ODI、NRS 疼痛、Short FES-I。

动作	描述
instruments	列出评估工具，可按领域筛选
instrument	完整规范：条目、回答选项、评分、ICF 映射
score	对回答进行评分 → 严重程度、解释、ICF 限定值
suggest	根据某种状况、ICF 代码或领域推荐评估工具
mapping	显示某个评估工具的 ICF 代码映射

元信息

动作	描述
overview	ICF 分类完整概览
api	原始 WHO API 请求（备用方式）
help	带示例的动作参考

调用示例：

{"action": "score", "name": "GAD-7", "responses": [1, 2, 1, 0, 1, 2, 1]}

评估工具和限定值相关动作仅依赖逻辑，无需 WHO API 凭据；代码/层级相关动作则需要凭据。

前置条件

1. WHO ICD-API 凭据（免费）：在 https://icd.who.int/icdapi 注册
2. Cloudflare 账户，并启用 Workers
3. Node.js 18+ 和 npm

安装

git clone https://github.com/stayce/icf-mcp-cloudflare.git
cd icf-mcp-cloudflare
npm install

配置

1. 复制环境变量示例文件：

   cp .dev.vars.example .dev.vars
   

2. 编辑 .dev.vars，填入 WHO API 凭据以用于本地开发。

3. 对于生产环境，设置机密：

   wrangler secret put WHO_CLIENT_ID
   wrangler secret put WHO_CLIENT_SECRET
   

开发

npm run dev

服务将在 http://localhost:8787 上提供。

测试

npm test

回归测试涵盖评估工具评分（全部 11 种工具）和限定值解析——这些都只依赖逻辑，无需 WHO API 凭据。

部署

npm run deploy

自定义域名（在 wrangler.toml 中配置）：

wrangler deploy --env production

与 Claude 配合使用

将以下内容添加到 Claude Desktop 配置文件中（macOS 上路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "icf": {
      "type": "url",
      "url": "https://mcp-icf.medseal.app/mcp"
    }
  }
}

或者，如果部署自己的服务：

{
  "mcpServers": {
    "icf": {
      "type": "url",
      "url": "https://your-worker.workers.dev/mcp"
    }
  }
}

端点

• / 或 /health - 健康检查/服务信息
• /mcp - MCP 协议端点（可流式传输的 HTTP）

API 参考

此服务使用 WHO ICD-API，该 API 提供对 ICD-11 和 ICF 分类的程序化访问。

• API 文档：https://icd.who.int/docs/icd-api/APIDoc-Version2/
• ICF 浏览器：https://icd.who.int/dev11/l-icf/en

许可证

MIT 许可证 - 详见 LICENSE

相关项目

• icf-mcp-server - 适用于 Claude Desktop 的 Python 版本