English Français العربية

io.github.stayce/icf-mcp

Registre officiel Santé

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http icf-mcp 'https://mcp-icf.medseal.app/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "icf-mcp": {
            "type": "http",
            "url": "https://mcp-icf.medseal.app/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. ICF MCP Server (Cloudflare Workers)
  2. What is ICF?
  3. Tool
  4. Prerequisites
  5. Installation
  6. Configuration
  7. Development
  8. Testing
  9. Deployment
  10. Usage with Claude
  11. Endpoints
  12. API Reference
  13. License
  14. Related

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:

{"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

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

Configuration

  1. Copy the example environment file:
     cp .dev.vars.example .dev.vars
  2. Edit .dev.vars with your WHO API credentials for local development.
  3. For production, set secrets:
     wrangler secret put WHO_CLIENT_ID
 wrangler secret put WHO_CLIENT_SECRET

Development

npm run dev

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

Testing

npm test

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

Deployment

npm run deploy

For custom domain (configured in wrangler.toml):

wrangler deploy --env production

Usage with Claude

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

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

Or if deploying your own:

{
  "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

Questions fréquentes

Qu'est-ce que io.github.stayce/icf-mcp ?

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

Comment installer io.github.stayce/icf-mcp ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http icf-mcp 'https://mcp-icf.medseal.app/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.stayce/icf-mcp ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.stayce/icf-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.stayce/icf-mcp ?

Il est publié par stayce. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.