Cid10 Br MCP

🚀 CID-10 BR MCP Server

A Model Context Protocol (MCP) server providing access to the Brazilian version of ICD-10 (CID-10)

🚀 Quick Start

This is a Model Context Protocol (MCP) server that offers access to the Brazilian version of ICD-10 (CID-10), maintained by DATASUS/Ministry of Health of Brazil.

✨ Features

• 🔍 Search: Search codes by term (code or description).
• 📋 Lookup: Get detailed information for a specific CID-10 code.
• 🌳 Hierarchy: Navigate the hierarchical structure (chapters, groups, categories, subcategories).
• 📊 Statistics: Obtain general statistics about the CID-10 database.
• ✅ Validation: Validate codes for use in health systems (SUS).

📦 Installation

Using with Claude Desktop

Add the following to your Claude Desktop configuration file:

• 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"]
    }
  }
}

Global Installation

npm install -g cid10-br-mcp

Then add the following to Claude Desktop config:

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

🛠️ Available Tools

💻 Usage Examples

Once configured, you can ask Claude the following questions:

• "What is CID-10 code A90?"
• "Search for diabetes codes in CID-10"
• "List all codes under category E11"
• "What are the chapters of CID-10?"
• "Is F32.1 a valid code for medical records?"

📊 Data Source

The data is sourced from official DATASUS:

• CID-10-CAPITULOS.CSV: 22 chapters
• CID-10-GRUPOS.CSV: Groups within chapters
• CID-10-CATEGORIAS.CSV: 3-character categories
• CID-10-SUBCATEGORIAS.CSV: Detailed subcategories

Source: DATASUS - CID-10

🔧 Technical Details

Prerequisites

• Node.js >= 18.0.0
• npm

Setup

# Clone the repository
git clone https://github.com/SidneyBissoli/cid10-br-mcp.git
cd cid10-br-mcp

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start

Testing with MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js

🤝 Contributing

Contributions are welcome! You can follow these steps:

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/new-feature).
3. Commit your changes (git commit -m 'Add new feature').
4. Push to the branch (git push origin feature/new-feature).
5. Open a Pull Request.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

👤 Author

Sidney Bissoli

• GitHub: @SidneyBissoli
• Email: sbissoli76@gmail.com

🔗 Links

• npm package
• MCP Registry
• Model Context Protocol
• DATASUS CID-10

Made with ❤️ for the Brazilian health community