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 分