fhirhydrant — MCP-сервер для Claude Code: установка
Подключает ИИ-клиенты к FHIR API и даёт инструменты для поиска, чтения и ограниченной записи клинических данных.
claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --env FHIR_AUTH=<FHIR_AUTH> --env FHIR_SERVER_URL=<FHIR_SERVER_URL> --env FHIR_TOKEN_URL=<FHIR_TOKEN_URL> --env FHIR_CLIENT_ID=<FHIR_CLIENT_ID> --transport stdio fhirhydrant -- npx -y fhirhydrantЧто делает fhirhydrant
fhirhydrant подключает MCP-клиенты к FHIR API версии R4 и выше. Сервер превращает работу с ресурсами, операциями, терминологией и страницами Bundle в инструменты для агента. Ресурсы настраиваются через JSON-файлы, а список доступных действий зависит от CapabilityStatement, SMART-областей и параметров сервера.
Сервер умеет искать и читать ресурсы, получать историю, вызывать именованные операции, фильтровать ответы через FHIRPath и ограничивать их размер. Запись включается отдельно через FHIR_WRITE_CAPABILITIES; доступны batch- и transaction-Bundle при дополнительной настройке. Для SMART Backend Services нужны регистрация клиента, закрытый ключ и публикация открытого ключа через JWKS. Для открытого тестового FHIR-сервера можно задать FHIR_AUTH=none.
Без Node.js версии >= 24 сервер не запустится. Ответы MCP могут содержать PHI, поэтому настройки хранения транскриптов и журналов клиента должны соответствовать требованиям вашей среды.
Какие задачи решает
- искать ресурсы FHIR по настроенным параметрам
- читать ресурс, его версию или историю изменений
- вызывать именованные клинические и терминологические операции
- сокращать ответы через FHIRPath и лимит размера
- проверять CapabilityStatement и доступные инструменты
Примеры запросов агенту
- Найди нужные ресурсы FHIR и верни компактный ответ.
- Покажи историю изменений ресурса по его идентификатору.
- Проверь CapabilityStatement и объясни, какие операции доступны.
Как установить fhirhydrant
Командой платформы
claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --env FHIR_AUTH=<FHIR_AUTH> --env FHIR_SERVER_URL=<FHIR_SERVER_URL> --env FHIR_TOKEN_URL=<FHIR_TOKEN_URL> --env FHIR_CLIENT_ID=<FHIR_CLIENT_ID> --transport stdio fhirhydrant -- npx -y fhirhydrantВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Командой платформы
codex mcp add fhirhydrant --env MCP_TRANSPORT=<MCP_TRANSPORT> --env FHIR_AUTH=<FHIR_AUTH> --env FHIR_SERVER_URL=<FHIR_SERVER_URL> --env FHIR_TOKEN_URL=<FHIR_TOKEN_URL> --env FHIR_CLIENT_ID=<FHIR_CLIENT_ID> -- npx -y fhirhydrantВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"fhirhydrant": {
"command": "npx",
"args": [
"-y",
"fhirhydrant"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"FHIR_AUTH": "<FHIR_AUTH>",
"FHIR_SERVER_URL": "<FHIR_SERVER_URL>",
"FHIR_TOKEN_URL": "<FHIR_TOKEN_URL>",
"FHIR_CLIENT_ID": "<FHIR_CLIENT_ID>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"fhirhydrant": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"fhirhydrant"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"FHIR_AUTH": "<FHIR_AUTH>",
"FHIR_SERVER_URL": "<FHIR_SERVER_URL>",
"FHIR_TOKEN_URL": "<FHIR_TOKEN_URL>",
"FHIR_CLIENT_ID": "<FHIR_CLIENT_ID>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e MCP_TRANSPORT=<MCP_TRANSPORT> -e FHIR_AUTH=<FHIR_AUTH> -e FHIR_SERVER_URL=<FHIR_SERVER_URL> -e FHIR_TOKEN_URL=<FHIR_TOKEN_URL> -e FHIR_CLIENT_ID=<FHIR_CLIENT_ID> fhirhydrant npx -y fhirhydrantВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о fhirhydrant
Как установить fhirhydrant в Claude Code?
Выполните `claude mcp add fhirhydrant -e MCP_TRANSPORT=<MCP_TRANSPORT> -e FHIR_AUTH=<FHIR_AUTH> -e FHIR_SERVER_URL=<FHIR_SERVER_URL> -e FHIR_ACTIVE_KEY=<FHIR_ACTIVE_KEY> -- npx -y fhirhydrant`.
Что делает fhirhydrant?
Он даёт MCP-клиенту инструменты для поиска, чтения и истории FHIR-ресурсов, вызова настроенных операций и обработки страниц Bundle. Доступные действия проверяются по конфигурации, CapabilityStatement и SMART-областям.
Что нужно для SMART-аутентификации?
Нужны поддерживаемый FHIR-сервер, регистрация SMART Backend Services-клиента, закрытый ключ и доступный через JWKS открытый ключ. Для неаутентифицированного тестового сервера используется FHIR_AUTH=none.
