omophub-mcp — MCP-сервер для Claude Code: что делает и как установить
Подключает медицинские словари OHDSI к ассистенту. Помогает сопоставлять коды ICD-10, SNOMED и RxNorm без развёртывания локальной базы данных.
claude mcp add omophub-mcp -e OMOPHUB_API_KEY=<OMOPHUB_API_KEY> -- npx -y @omophub/omophub-mcpЧто делает omophub-mcp
Сервер открывает доступ к каталогу понятий ATHENA прямо из интерфейса редактора или терминала. Вместо ручной загрузки объёмных архивов и написания SQL-запросов агент обращается к удалённому индексу через инструменты search_concepts, get_hierarchy и map_concept. Это ускоряет построение когорт.
Внутри реализованы семантический поиск через векторные эмбеддинги, проверка кодов и навигация по иерархиям терминов. Для вызовов серверу обязательно требуется токен OMOPHUB_API_KEY. Без действующего ключа авторизации ни один запрос к словарям не выполнится. Запуск возможен локально через npx либо в виде отдельного сетевого сервиса.
Какие задачи решает
- найти идентификатор концепта в базе OMOP по клиническому описанию
- сопоставить диагноз из классификатора ICD-10 со стандартом SNOMED
- построить дерево предков и потомков термина для фенотипирования
- проверить корректность медицинских кодов перед формированием выборки
Примеры запросов агенту
- Найди стандартный идентификатор OMOP для бронхиальной астмы.
- Сопоставь код МКБ-10 E11.9 с соответствующим понятием в SNOMED.
- Покажи всех прямых потомков диагноза гипертоническая болезнь в словаре SNOMED.
Как установить omophub-mcp
Командой платформы
claude mcp add omophub-mcp -e OMOPHUB_API_KEY=<OMOPHUB_API_KEY> -- npx -y @omophub/omophub-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add omophub-mcp --env OMOPHUB_API_KEY=<OMOPHUB_API_KEY> -- npx -y @omophub/omophub-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"omophub-mcp": {
"command": "npx",
"args": [
"-y",
"@omophub/omophub-mcp"
],
"env": {
"OMOPHUB_API_KEY": "<OMOPHUB_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"omophub-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@omophub/omophub-mcp"
],
"env": {
"OMOPHUB_API_KEY": "<OMOPHUB_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e OMOPHUB_API_KEY=<OMOPHUB_API_KEY> omophub-mcp npx -y @omophub/omophub-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о omophub-mcp
Как установить omophub-mcp в Claude Code?
Выполните команду claude mcp add omophub-mcp -e OMOPHUB_API_KEY=<OMOPHUB_API_KEY> -- npx -y @omophub/omophub-mcp. Вместо плейсхолдера подставьте собственный ключ доступа.
Что делает сервер omophub-mcp?
Он предоставляет языковой модели функции поиска, трансляции и проверки медицинских классификаторов. Инструмент связывает терминологии ICD-10, SNOMED, LOINC и RxNorm без ручной настройки баз данных.
Нужен ли отдельный ключ для работы с сервером?
Да, для отправки запросов понадобится действующий токен OMOPHUB_API_KEY. Его создают в личном кабинете на сервисе OMOPHub перед запуском интеграции.