MCP Server Healthcare

Сервер Model Context Protocol (MCP) для рабочего процесса клинического кодирования NHS — предложение кодов ICD-10-CM/OPCS-4/HCC для клинической заметки, отслеживание запросов SAR/FOI по управлению информацией, выполнение запросов репозитория сопоставления DSAR через классификацию и клиническую проверку, пакетное кодирование, а также чтение/запись данных пациентов через песочницу Cerner FHIR R4.

Любой MCP-клиент (Claude Desktop, Claude Code, MCP-коннектор Copilot Studio и т. д.) может вызывать эти инструменты напрямую — слой REST API не требуется.

Изначально создан как часть bobbynoble/clinical-coding-bot; этот репозиторий является автономным MCP-сервером с собственной копией бизнес-логики, которую он оборачивает, поэтому он не зависит от того репозитория.

Инструменты

cerner_post_condition, cerner_post_procedure и cerner_writeback_episode выполняют реальные записи в настроенную среду Cerner (по умолчанию — непродакшн-песочница; см. app/fhir_cerner.py).

Related MCP server: fhir-synthetic-mcp

Настройка

pip install -r requirements.txt
cp .env.example .env   # fill in Azure OpenAI / Search / Cerner credentials as needed

Каждый инструмент загружается независимо от того, какие учетные данные заданы, но suggest_clinical_codes требует настройки Azure OpenAI + Azure AI Search, а инструменты cerner_* требуют CERNER_CLIENT_ID/CERNER_CLIENT_SECRET — вызов без соответствующих учетных данных завершается понятной ошибкой, а не падением сервера.

Запуск

Stdio (Claude Desktop, Claude Code, большинство локальных MCP-клиентов):

python -m MCP_Server_Healthcare

Пример конфигурации Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "clinical-coding-bot": {
      "command": "python",
      "args": ["-m", "MCP_Server_Healthcare"],
      "cwd": "/absolute/path/to/mcp_server_healthcare"
    }
  }
}

Streamable HTTP (удаленный доступ, например из Copilot Studio или размещенного MCP-клиента):

python -m MCP_Server_Healthcare --transport http --port 8010

HTTP-транспорт требует установки CODING_API_KEY в .env — каждый запрос должен содержать соответствующий заголовок X-API-Key, иначе он отклоняется с кодом 401 (закрытый отказ). По умолчанию он слушает 127.0.0.1; установите MCP_HOST=0.0.0.0 (и поместите за TLS/обратным прокси), чтобы открыть доступ за пределами localhost.

Структура репозитория

MCP_Server_Healthcare/   the MCP server itself (server.py has the tool
                         definitions; __main__.py the stdio/http entry point;
                         auth.py the HTTP transport's API-key gate)
app/                     business logic each tool wraps — coder.py (RAG
                         coding), sar_foi.py, dsar.py, batch.py,
                         fhir_cerner.py. Each stores its state in a SQLite
                         file created alongside it on first run.

Примечания

• Блокирующие сетевые вызовы (Azure OpenAI/Search, Cerner FHIR) выгружаются с помощью asyncio.to_thread, чтобы один медленный вызов не останавливал другие вызовы инструментов на том же сервере.

• Файлы SQLite (app/sar_foi.db, app/batch.db, app/dsar.db) создаются автоматически при первом запуске и игнорируются git.