# medical-codes-mcp-server

MCP-сервер medical-codes-mcp-server для Claude Code предоставляет локальный справочник медицинских кодов США для расшифровки, поиска по описанию, проверки биллабельности и кроссволков между системами.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 422 установки · ★ 4 у репозитория
- Автор: cyanheads
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/cyanheads/medical-codes-mcp-server
- Обновлён: 2026-10-08
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/medical-codes-mcp-server

## Что делает

Сервер поднимает локальный индекс медицинских кодов США и отдаёт его шестью инструментами. `medcode_get_code` расшифровывает до 50 кодов за вызов, `medcode_search_codes` ищет по официальным описаниям, `medcode_check_code` проверяет существование и биллабельность, `medcode_map_codes` связывает код с родителями и детьми, препарат — с RXCUI, NDC и классами RxClass.

Внутри одна база SQLite с полнотекстовым поиском FTS5, собранная при публикации пакета и открытая только на чтение. В неё входят ICD-10-CM, ICD-10-PCS, HCPCS Level II, RxNorm и слой классов RxClass. Ключ API не нужен: данные лежат рядом с сервером.

Какие выпуски справочников активны, показывает `medcode_list_systems` — набор фиксируется в момент сборки пакета. Часть лицензионных слоёв RxClass, например ATC и SNOMED CT, в сборку не попала. Выдача справочная: пометка о биллабельности не заменяет сверку с выпусками CMS, CDC/NCHS и NLM и с правилами плательщика.

## Требования
- Удалённый сервер: `https://medical-codes-mcp-server--cyanheads.run.tools`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http medical-codes-mcp-server https://medical-codes-mcp-server--cyanheads.run.tools
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add medical-codes-mcp-server --url https://medical-codes-mcp-server--cyanheads.run.tools
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "medical-codes-mcp-server": {
            "url": "https://medical-codes-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "medical-codes-mcp-server": {
            "type": "http",
            "url": "https://medical-codes-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http medical-codes-mcp-server https://medical-codes-mcp-server--cyanheads.run.tools
```

## Когда брать
- расшифровать пачку кодов диагноза из выгрузки
- найти код по текстовому описанию процедуры
- проверить, действует ли код и можно ли его выставлять
- сопоставить препарат с RXCUI, NDC и классами
- пройтись по иерархии системы без поискового запроса

## Примеры запросов агенту
- Расшифруй коды из `claims.csv` и скажи, какие из них биллабельные
- Найди код ICD-10-CM под описание «боль в пояснице»
- Сопоставь RXCUI `1191` с торговыми названиями и классами RxClass

## Похожие
- [Medical Terminologies MCP](https://affpapa.org/nevibecode/mcp/medical-terminologies-mcp.md) — MCP-сервер · ★ 16 у репозитория
- [agency-medical-billing-coding-specialist](https://affpapa.org/nevibecode/skills/agency-medical-billing-coding-specialist.md) — скилл · ★ 85 у репозитория
- [local-first](https://affpapa.org/nevibecode/skills/local-first.md) — скилл · 173 установки
- [Horosa Skill](https://affpapa.org/nevibecode/mcp/horosa-skill.md) — MCP-сервер · ★ 525 у репозитория
- [omophub-mcp](https://affpapa.org/nevibecode/mcp/omophub-mcp.md) — MCP-сервер · ★ 7 у репозитория
- [OraFabric Medical Ontology Knowledge Base](https://affpapa.org/nevibecode/mcp/orafabric-medical-ontology-knowledge-base.md) — MCP-сервер · ★ 1 у репозитория

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
