JinDaGe - icf-mcp-cloudflare MCP Details

article

README

🚀 ICF MCP 服务器（Cloudflare Workers）

这是一个适用于世界卫生组织（WHO）国际功能、残疾和健康分类（ICF）的模型上下文协议（MCP）服务器，部署在 Cloudflare Workers 上，以实现全球边缘可用性。

实时访问地址：https://mcp-icf.medseal.app/mcp

🚀 快速开始

本服务器是基于 Cloudflare Workers 部署的 ICF MCP 服务器，可通过特定的 API 接口对 ICF 分类进行查询和操作。

✨ 主要特性

提供全球边缘可用性，通过 Cloudflare Workers 部署。
支持多种 ICF 相关的查询工具，如代码查找、关键词搜索等。
与 WHO ICD-API 集成，可访问 ICD-11 和 ICF 分类。

📦 安装指南

前提条件

WHO ICD-API 凭证（免费）：在 https://icd.who.int/icdapi 注册。
启用 Workers 的 Cloudflare 账户。
Node.js 18+ 和 npm。

安装步骤

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

配置

复制示例环境文件：
```
cp .dev.vars.example .dev.vars
```
编辑 .dev.vars 文件，填入 WHO API 凭证以进行本地开发。

在生产环境中，设置密钥：

wrangler secret put WHO_CLIENT_ID
wrangler secret put WHO_CLIENT_SECRET

开发

npm run dev

服务器将在 http://localhost:8787 可用。

部署

npm run deploy

若要使用自定义域名（在 wrangler.toml 中配置）：

wrangler deploy --env production

💻 使用示例

基础用法

与 Claude 一起使用

在 macOS 上，将以下内容添加到 Claude 桌面配置文件（~/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"
    }
  }
}

📚 详细文档

什么是 ICF？

ICF 是世界卫生组织的一种分类方法，它通过描述健康状况如何影响一个人在日常生活中的功能，对 ICD（诊断代码）进行补充：

身体功能（b） - 生理和心理功能
身体结构（s） - 身体的解剖部位
活动和参与（d） - 任务执行和生活参与
环境因素（e） - 物理、社会和态度环境

工具

| 工具 | 描述 | |------|-------------| | icf_lookup | 查找特定的 ICF 代码（例如，b280，d450） | | icf_search | 通过关键词搜索（例如，“行走困难”，“疼痛”） | | icf_browse_category | 浏览顶级类别：b，s，d，e | | icf_get_children | 获取代码的子类别 | | icf_explain_qualifier | 解释严重程度评级（0 - 4，8，9） | | icf_overview | 完整的 ICF 分类概述 |

端点

/ 或 /health - 健康检查 / 服务器信息
/mcp - MCP 协议端点（可流式传输的 HTTP）

API 参考

本服务器使用 WHO ICD-API，该 API 提供对 ICD-11 和 ICF 分类的编程访问。

API 文档：https://icd.who.int/docs/icd-api/APIDoc-Version2/
ICF 浏览器：https://icd.who.int/dev11/l-icf/en

📄 许可证

本项目采用 MIT 许可证 - 详情请见 LICENSE。

icf-mcp-cloudflare