JinDaGe - cid10-br-mcp MCP Details

article

README

🚀 巴西 ICD - 10（CID - 10）MCP 服务器

这是一个基于模型上下文协议（MCP）的服务器，可提供对巴西版 ICD - 10（CID - 10）的访问，该版本由巴西卫生部下属的 DATASUS 维护。

🚀 快速开始

本项目是一个用于访问巴西版 ICD - 10（CID - 10）的 MCP 服务器，以下将介绍其安装和使用方法。

✨ 主要特性

🔍 搜索：通过术语（代码或描述）搜索代码。
📋 查询：获取特定 CID - 10 代码的详细信息。
🌳 层级结构：浏览层级结构（章节、组、类别、子类别）。
📊 统计信息：获取 CID - 10 数据库的一般统计信息。
✅ 验证：验证代码在卫生系统（SUS）中的使用。

📦 安装指南

在 Claude Desktop 中使用

添加到你的 Claude Desktop 配置文件：

Windows：%APPDATA%\Claude\claude_desktop_config.json
macOS：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cid10-br": {
      "command": "npx",
      "args": ["cid10-br-mcp"]
    }
  }
}

全局安装

npm install -g cid10-br-mcp

然后添加到 Claude Desktop 配置：

{
  "mcpServers": {
    "cid10-br": {
      "command": "cid10-br-mcp"
    }
  }
}

🛠️ 可用工具

| 工具 | 描述 | |------|-------------| | cid10_search | 通过术语（代码或描述）搜索 CID - 10 代码 | | cid10_lookup | 获取特定代码的详细信息 | | cid10_hierarchy | 获取类别/前缀下的所有代码 | | cid10_capitulos | 列出 CID - 10 的所有 22 个章节 | | cid10_stats | 获取数据库的一般统计信息 | | cid10_validar | 验证代码在卫生系统中的使用 |

💻 使用示例

配置完成后，你可以向 Claude 提问：

“CID - 10 代码 A90 是什么？”
“在 CID - 10 中搜索糖尿病代码”
“列出 E11 类别下的所有代码”
“CID - 10 的章节有哪些？”
“F32.1 是有效的病历代码吗？”

📊 数据来源

数据来自 DATASUS 官方来源：

CID - 10 - CAPITULOS.CSV - 22 个章节
CID - 10 - GRUPOS.CSV - 章节内的组
CID - 10 - CATEGORIAS.CSV - 3 字符类别
CID - 10 - SUBCATEGORIAS.CSV - 详细子类别

来源：DATASUS - CID - 10

🔧 技术细节

前提条件

Node.js >= 18.0.0
npm

项目设置

# 克隆仓库
git clone https://github.com/SidneyBissoli/cid10-br-mcp.git
cd cid10-br-mcp

# 安装依赖
npm install

# 构建项目
npm run build

# 本地运行
npm start

使用 MCP Inspector 进行测试

npx @modelcontextprotocol/inspector node dist/index.js

🤝 贡献说明

欢迎贡献代码！你可以按照以下步骤进行：

分叉仓库
创建功能分支 (git checkout -b feature/new-feature)
提交更改 (git commit -m 'Add new feature')
推送到分支 (git push origin feature/new-feature)
打开拉取请求

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

👤 作者

Sidney Bissoli

GitHub: @SidneyBissoli
邮箱: sbissoli76@gmail.com

🔗 链接

为巴西卫生界用心打造 ❤️

cid10-br-mcp