Icf Mcp

io.github.stayce由 GitHub 账号 stayce 发布v1.1.0更新于 Oct 25, 2026

WHO ICF codes: lookup, search, hierarchy, qualifiers, and 11 scored clinical assessment instruments.

已验证Streamable HTTP可网页运行位置与生活知识与记忆数据与分析

概览

AI 生成的概览

面向 WHO ICF 功能分类代码与临床评估量表的远程 MCP 服务器，让助手查询、搜索并计分。

可以做什么
查询、搜索、浏览并导航 ICF 代码，包括子类、父类、同级代码、层级链以及由多个代码构成的功能画像。查看限定符参考、校验代码并解析完整限定代码。列出并查看 11 种临床评估量表的条目、计分方式与 ICF 映射。对作答计分并给出严重程度与解读，按病症、代码或领域推荐量表。获取分类总览或发送原始 WHO API 请求。
适用场景
适合助手需要处理 WHO ICF 功能与残疾代码、构建功能画像，或使用 GAD-7、PHQ-9、WHODAS 2.0 等标准化临床评估量表并将结果映射到 ICF 限定符的场景。
运行要求
远程端点，无需本地安装。代码与层级相关操作依赖 WHO ICD-API，需要免费的 WHO ICD-API 凭据（客户端 ID 与密钥），由服务器端配置。量表与限定符操作无需这些凭据。需要能访问该端点的网络。
安装前请注意
该服务器由第三方提供，临床内容仅供参考；计分与解读不应视为诊断。原始 WHO API 操作会透传任意请求。代码与层级查询依赖服务器运营方持有的 WHO API 凭据，而非你自己的凭据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Icf Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.stayce%2Ficf-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

ICF MCP Server (Cloudflare Workers)

A Model Context Protocol (MCP) server for the WHO International Classification of Functioning, Disability and Health (ICF), deployed on Cloudflare Workers for global edge availability.

Live URL: https://mcp-icf.medseal.app/mcp

What is ICF?

The ICF is a WHO classification that complements ICD (diagnosis codes) by describing how health conditions affect a person's functioning in daily life:

  • Body Functions (b) - Physiological and psychological functions
  • Body Structures (s) - Anatomical parts of the body
  • Activities and Participation (d) - Task execution and life involvement
  • Environmental Factors (e) - Physical, social, and attitudinal environment

Tool

A single icf tool with action dispatch (token-efficient). 19 actions:

Codes & Hierarchy

ActionDescription
lookupLook up a specific ICF code (e.g., b280, d450)
searchSearch by keyword (e.g., "walking difficulty", "pain")
browseBrowse a category (b, s, d, e) or sub-chapter (b1, d4, e3)
childrenGet subcategories of a code
parentNavigate up to a code's parent category
siblingsCodes at the same level (same parent)
chainFull hierarchy path from root to a code
profileBuild a functional profile from multiple codes

Qualifiers

ActionDescription
qualifierComponent-specific qualifier reference (b=1, s=3, d=2, e=barrier/facilitator)
validateValidate code format + qualifiers, verify existence in the WHO API
parseParse fully qualified codes (d450.23, s730.312, e120+3)

Clinical Assessment Instruments

11 standardized RPM instruments with items, scoring, and ICF mappings: GAD-7, PHQ-9, RADAI-5, SLEDAI-2K, WHODAS 2.0, HAQ-DI, PROMIS-10, CAT, ODI, NRS Pain, Short FES-I.

ActionDescription
instrumentsList instruments, optionally filtered by domain
instrumentFull spec: items, response options, scoring, ICF mappings
scoreScore responses → severity, interpretation, ICF qualifier
suggestSuggest instruments for a condition, ICF code, or domain
mappingShow an instrument's ICF code mappings

Meta

ActionDescription
overviewFull ICF classification overview
apiRaw WHO API request (escape valve)
helpAction reference with examples

Example call:

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

Instrument and qualifier actions are pure logic and work without WHO API credentials; code/hierarchy actions require them.

Prerequisites

  1. WHO ICD-API credentials (free): Register at https://icd.who.int/icdapi
  2. Cloudflare account with Workers enabled
  3. Node.js 18+ and npm

Installation

bash
git clone https://github.com/stayce/icf-mcp-cloudflare.gitcd icf-mcp-cloudflarenpm install

Configuration

  1. Copy the example environment file:

    bash
    cp .dev.vars.example .dev.vars

  2. Edit .dev.vars with your WHO API credentials for local development.

  3. For production, set secrets:

    bash
    wrangler secret put WHO_CLIENT_IDwrangler secret put WHO_CLIENT_SECRET

Development

bash
npm run dev

The server will be available at http://localhost:8787.

Testing

bash
npm test

Regression tests cover instrument scoring (all 11 instruments) and qualifier parsing — pure logic, no WHO API credentials needed.

Deployment

bash
npm run deploy

For custom domain (configured in wrangler.toml):

bash
wrangler deploy --env production

Usage with Claude

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

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

Or if deploying your own:

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

Endpoints

  • / or /health - Health check / server info
  • /mcp - MCP protocol endpoint (streamable HTTP)

API Reference

This server uses the WHO ICD-API which provides programmatic access to both ICD-11 and ICF classifications.

License

MIT License - see LICENSE

Related

来源：README.md，提交 b04b1b7

工具

1

icf

输入参数codenamepathcodesqueryaction必填domaincategorycomponentconditionqualifierresponses另有 1 个

版本历史

1
  1. v1.1.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分