icd-mcp について
icd-mcpは、WHOのICD-10とICD-11データをAIアシスタントに提供し、コードの検索、照会、検証、分類の閲覧を可能にします。WHOのICD-11エンジンによる臨床テキストの自動コーディングにも対応し、コーダー、開発者、研究者向けです。
主な機能
- 01ICD-10とICD-11コードの照会
- 02ICD-11テキストの検索と自動コーディング
- 03分類階層の閲覧
- 04コードの検証と祖先の追跡
- 05コーディング規則と概要の参照
活用シーン
- 01臨床記述からコードを検索
- 02コードの定義と有効性を確認
- 03コード階層と章を調査
- 04コーディング規則を参照
MCP 対応
照会、検索、自動コーディング、検証、WHO APIアクセスなど12の操作をMCPサーバー経由で提供します。MCP対応クライアントはホスト済みエンドポイントまたはセルフデプロイしたインスタンスに接続できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://icd-mcp-server.staycek.workers.dev/mcpclaude mcp add --transport http stayce-icd https://icd-mcp-server.staycek.workers.dev/mcp{"mcpServers":{"stayce-icd":{"type":"http","url":"https://icd-mcp-server.staycek.workers.dev/mcp"}}}Cursor で開く{"servers":{"stayce-icd":{"type":"http","url":"https://icd-mcp-server.staycek.workers.dev/mcp"}}}VS Code で開く{"mcpServers":{"stayce-icd":{"type":"http","url":"https://icd-mcp-server.staycek.workers.dev/mcp"}}}{"mcpServers":{"stayce-icd":{"serverUrl":"https://icd-mcp-server.staycek.workers.dev/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
1| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| code | string | いいえ | ICD コード(例:A00、J18.9、BA00) |
| path | string | いいえ | 生リクエスト用の API パス |
| query | string | いいえ | 検索語(ICD-11 のみ) |
| action | enum | はい | lookup | search | chapters | children | api | help |
| chapter | string | いいえ | 絞り込みに使用する章コード |
| version | enum | いいえ | ICD バージョン:10 または 11(デフォルト:11)10 | 11 |
| max_results | number | いいえ | 最大結果数(デフォルトは 10) |
詳細
ICD MCP Server
あらゆるAIアシスタントから、WHO ICD-10およびICD-11の分類体系にすぐにアクセスできます。これらは、世界中のあらゆる診断コード、病院の請求書、死亡統計を支える世界標準です。
12のアクション。ICDの両バージョンに対応。ツール呼び出しは1回。
https://mcp-icd.medseal.app/mcp
できること
臨床テキストをICD-11コードに自動変換
自由記述の臨床内容を貼り付けると、適切なコードを取得できます。手動で検索する必要はありません。
{"action": "autocode", "query": "acute bronchitis with fever"}
→ CA20 Acute bronchitis (92.3% confidence)
{"action": "autocode", "query": "patient presents with chest pain and shortness of breath"}
→ MD81 Chest pain (87.1% confidence)
ICD-10またはICD-11のコードをすぐに検索
定義、コーディング上の注記、包含項目、除外項目など、コーダーに必要なすべての情報を取得できます。
{"action": "lookup", "code": "BA00"}
→ BA00: Lobar pneumonia — full definition, coding notes, inclusions/exclusions
{"action": "lookup", "code": "J18.9", "version": "10"}
→ J18.9: Pneumonia, unspecified (ICD-10)
キーワードで検索
コードがわからなくても、内容を説明すれば、関連度順に結果が表示されます。
{"action": "search", "query": "type 2 diabetes with kidney complications"}
→ Ranked ICD-11 results with codes and titles
{"action": "search", "query": "melanoma", "chapter": "02", "max_results": 5}
→ Filtered to neoplasm chapter
分類体系をツリー形式で閲覧
対話形式でたどり、任意のコードの親コード、子コード、階層内の位置を確認できます。
{"action": "browse"}
→ All 28 ICD-11 chapters (or 21 ICD-10 chapters)
{"action": "browse", "code": "BA00"}
→ Parent context + sub-categories with ▸ expansion markers
コードの系譜をたどる
任意の末端コードから章のルートまで、上位の階層をたどれます。
{"action": "ancestors", "code": "BA01.0"}
→ BA01.0 → BA01 → BA0Y-BA2Z → Diseases of the respiratory system → Chapter 12
コードをすぐに検証
はい/いいえですばやく確認できます。実在するコードか、末端コードかカテゴリかを判定します。
{"action": "validate", "code": "BA00"}
→ Valid ICD-11 code, category level, has sub-codes
{"action": "validate", "code": "XYZ99"}
→ Not a valid ICD-11 code
コーディング規則を内蔵
コーディングのガイドラインを確認するために、会話を離れる必要はありません。
{"action": "coding_rules", "topic": "extension_codes"}
→ Full guide to ICD-11 severity, temporality, anatomy, histopathology codes
{"action": "coding_rules", "topic": "clustering"}
→ How to combine codes with & and / operators
{"action": "coding_rules", "topic": "dagger_asterisk"}
→ ICD-10 etiology/manifestation dual coding system
利用可能なトピック:extension_codes、clustering、sequencing、dagger_asterisk、postcoordination
全体像を把握
各分類体系の概要、章の一覧、主要な概念、相違点を確認できます。
{"action": "overview"}
→ ICD-11: 28 chapters, postcoordination, extension codes, what changed from ICD-10
{"action": "overview", "version": "10"}
→ ICD-10: 21 chapters, code ranges, dagger/asterisk system
12のアクション一覧
| アクション | 機能 | ICD-10 | ICD-11 |
|---|---|---|---|
lookup | 定義を含むコードの詳細情報を取得 | はい | はい |
search | キーワードでコードを検索 | - | はい |
autocode | 臨床テキストに最も合致するコードを提示 | - | はい |
browse | 階層を対話形式でたどる | はい | はい |
chapters | 分類体系の全章を一覧表示 | はい | はい |
children | 任意のコードの下位コードを取得 | はい | はい |
ancestors | 章のルートまで系譜をたどる | はい | はい |
validate | コードの存在と階層レベルを確認 | はい | はい |
coding_rules | コーディング規則のリファレンス | はい | はい |
overview | 分類体系の概要 | はい | はい |
api | WHO APIに直接アクセス | はい | はい |
help | アクションのリファレンスと使用例 | - | - |
対象ユーザー
- 臨床アプリ、EHR、コーディングツールを開発するヘルスIT開発者
- AIによるコード検索と検証を活用したい医療コーダー
- 分類構造を調査する医療データアナリスト
- WHOの死亡率・罹患率データを扱う研究者
- エージェントに医療コーディング機能を追加するAI/LLM開発者
- ICD-10からICD-11への移行にあたり、両方の体系を並べて参照したいすべての方
クイックスタート
ホストされたサーバーを使う(最速)
Claude Desktopのclaude_desktop_config.jsonに追加します。
{
"mcpServers": {
"icd": {
"type": "url",
"url": "https://mcp-icd.medseal.app/mcp"
}
}
}
または、https://mcp-icd.medseal.app/mcpを使って、MCP互換クライアントから接続します。
独自のサーバーをデプロイする
-
クローンしてインストール:
git clone https://github.com/stayce/icd-mcp-cloudflare cd icd-mcp-cloudflare npm install -
WHO APIの認証情報を取得(無料):
- https://icd.who.int/icdapi で登録します
- Client IDとSecretを取得します
-
シークレットを設定してデプロイ:
wrangler secret put WHO_CLIENT_ID wrangler secret put WHO_CLIENT_SECRET npm run deploy
これで完了です。Cloudflareのエッジネットワーク上で、世界中から利用できます。
この MCP を選ぶ理由
トークン効率に優れています。 1 つのツールで 12 のアクションを実行できます。コンテキストウィンドウを消費する、肥大化したツールリストはありません。
ICD の両バージョンに対応しています。 ICD-10 は今もあらゆる場所で請求に使われています。ICD-11 は今後の標準です。どちらも必要です。デフォルトは ICD-11 です。ICD-10 には "version": "10" を追加してください。
WHO の公式データを使用しています。 古いコピーやスクレイピングしたデータセットではなく、WHO ICD-API から直接取得します。
自動コーディングは本格的です。 キーワードを使った小手先の仕組みではなく、WHO 独自の自動コーディングエンジンです。臨床テキストを渡すと、適切なコードが得られます。
コールドスタートはゼロです。 コンテナではなく Cloudflare Workers を使用しています。世界中で 50 ミリ秒未満です。
ICD-10 と ICD-11 の比較
| ICD-10 | ICD-11 | |
|---|---|---|
| 採択年 | 1990 | 2019 |
| コード数 | 約 14,400 | 約 17,000 |
| 形式 | A00.0–Z99.9 | BA00, 1A00.1 |
| 検索 | WHO API では非対応 | 全文検索+フレキシサーチ |
| 自動コーディング | 利用不可 | 対応 |
| 主な機能 | 剣印/星印による二重コーディング | ポストコーディネーション+拡張コード |
| ステータス | 請求では今も主流 | 2022 年 1 月から正式に発効 |
このサーバーは ICD-11 をデフォルトとしますが、両方に完全対応しています。ICD-10 のクエリには "version": "10" を使用してください。
MedSeal MCP Suite の一部
| サーバー | 分類 | リンク |
|---|---|---|
| ICD MCP(本サーバー) | WHO ICD-10/ICD-11 診断コード | icd-mcp-cloudflare |
| ICF MCP | WHO ICF の生活機能と障害 | icf-mcp-cloudflare |
| Part D MCP | CMS Medicare Part D の薬剤支出 | partd-mcp-cloudflare |
すべて Cloudflare Workers にデプロイされています。すべてオープンソースです。すべて MCP 互換です。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。