icf-mcp

ICF MCP サーバー（Cloudflare Workers）

WHO 国際生活機能分類（ICF）向けのModel Context Protocol（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）を解析します

臨床評価尺度

項目、採点方法、ICF マッピングを含む 11 種類の標準化 RPM 尺度： GAD-7、PHQ-9、RADAI-5、SLEDAI-2K、WHODAS 2.0、HAQ-DI、PROMIS-10、CAT、ODI、NRS Pain、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. Workers が有効になっている Cloudflare アカウント
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. ローカル開発用の WHO API 認証情報を .dev.vars に記入します。

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 リファレンス

このサーバーは、ICD-11 と ICF の両方の分類にプログラムからアクセスできる WHO ICD-API を使用しています。

• 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 版