terminologia — MCP-сервер для Claude Code: что делает и как установить
Подключает агента к справочникам здравоохранения и стандартам FHIR. Помогает искать и валидировать медицинские коды CID-10, TUSS или LOINC.
claude mcp add --env TERMINOLOGIA_KEY=<TERMINOLOGIA_KEY> --env TERMINOLOGIA_URL=<TERMINOLOGIA_URL> --transport stdio terminologia -- uvx terminologiaЧто делает terminologia
Сервер открывает ИИ-агентам доступ к медицинским классификаторам через FHIR API платформы Voa Health. Внутри доступны поиск концептов и валидация кодов. Инструмент поддерживает международные базы вроде LOINC и UCUM, а также бразильские стандарты TISS, SIGTAP, CBO и реестры ANVISA.
Для запуска через uvx требуется ключ доступа. Без действующего TERMINOLOGIA_KEY сервер не сможет запрашивать данные из API. По умолчанию запросы идут на https://terminologia.voa.health/api/v1/fhir, но адрес меняется через TERMINOLOGIA_URL.
Какие задачи решает
- найти код диагноза в справочниках CID-10 или CIAP-2
- проверить корректность медицинского кода TUSS или SIGTAP
- перевести кодировку между разными системами классификации
- получить сведения об учреждениях через реестр CNES
Примеры запросов агенту
- Найди код CID-10 по описанию боли в грудной клетке
- Проверь код 10101012 в справочнике TUSS
- Найди клиники по запросу hospital das clínicas в базе CNES
Как установить terminologia
Командой платформы
claude mcp add --env TERMINOLOGIA_KEY=<TERMINOLOGIA_KEY> --env TERMINOLOGIA_URL=<TERMINOLOGIA_URL> --transport stdio terminologia -- uvx terminologiaВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from terminologia <команда>
Командой платформы
codex mcp add terminologia --env TERMINOLOGIA_KEY=<TERMINOLOGIA_KEY> --env TERMINOLOGIA_URL=<TERMINOLOGIA_URL> -- uvx terminologiaВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from terminologia <команда>
Файл настроек
{
"mcpServers": {
"terminologia": {
"command": "uvx",
"args": [
"terminologia"
],
"env": {
"TERMINOLOGIA_KEY": "<TERMINOLOGIA_KEY>",
"TERMINOLOGIA_URL": "<TERMINOLOGIA_URL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from terminologia <команда>
Файл настроек
{
"servers": {
"terminologia": {
"type": "stdio",
"command": "uvx",
"args": [
"terminologia"
],
"env": {
"TERMINOLOGIA_KEY": "<TERMINOLOGIA_KEY>",
"TERMINOLOGIA_URL": "<TERMINOLOGIA_URL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from terminologia <команда>
Командой платформы
gemini mcp add -e TERMINOLOGIA_KEY=<TERMINOLOGIA_KEY> -e TERMINOLOGIA_URL=<TERMINOLOGIA_URL> terminologia uvx terminologiaВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from terminologia <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о terminologia
Как установить terminologia в Claude Code?
Запустите команду claude mcp add terminologia -e TERMINOLOGIA_KEY=<TERMINOLOGIA_KEY> -- uvx terminologia. Вместо плейсхолдера передайте действующий ключ организации.
Что делает MCP-сервер terminologia?
Он даёт LLM инструменты для поиска, проверки и сопоставления медицинских кодов через FHIR-интерфейс, охватывая базы TUSS, TISS, CID-10 и LOINC.
Какой API-ключ нужен для работы сервера?
Подойдёт ключ организации sk_voa_... из личного кабинета Voa либо старый ключ sk_tiss_ с включённым разрешением terminology:read.
