MCP Server Healthcare

Un servidor de Model Context Protocol (MCP) para un flujo de trabajo de codificación clínica del NHS: sugerir códigos ICD-10-CM/OPCS-4/HCC para una nota clínica, realizar un seguimiento de las solicitudes de gobernanza de la información SAR/FOI, ejecutar solicitudes del repositorio de mapeo DSAR a través de clasificación y revisión clínica, codificación por lotes y lectura/escritura de datos de pacientes a través de un sandbox de Cerner FHIR R4.

Cualquier cliente MCP (Claude Desktop, Claude Code, el conector MCP de Copilot Studio, etc.) puede llamar a estas herramientas directamente: no se requiere una capa de API REST.

Originalmente construido como parte de bobbynoble/clinical-coding-bot; este repositorio es el servidor MCP independiente, con su propia copia de la lógica de negocio que envuelve, por lo que no tiene dependencia de ese repositorio.

Herramientas

cerner_post_condition, cerner_post_procedure y cerner_writeback_episode realizan escrituras reales contra el entorno de Cerner que esté configurado (un sandbox de no producción por defecto; consulte app/fhir_cerner.py).

Related MCP server: fhir-synthetic-mcp

Configuración

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

Cada herramienta se carga independientemente de qué credenciales estén configuradas, pero suggest_clinical_codes necesita Azure OpenAI + Azure AI Search configurados, y las herramientas cerner_* necesitan CERNER_CLIENT_ID/CERNER_CLIENT_SECRET; llamar a una sin las credenciales correspondientes falla con un error claro en lugar de bloquear el servidor.

Ejecución

Stdio (Claude Desktop, Claude Code, la mayoría de los clientes MCP locales):

python -m MCP_Server_Healthcare

Ejemplo de configuración de Claude Desktop (claude_desktop_config.json):

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

HTTP transmisible (acceso remoto, p. ej., desde Copilot Studio o un cliente MCP alojado):

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

El transporte HTTP requiere que CODING_API_KEY esté configurada en .env; cada solicitud debe llevar un encabezado X-API-Key correspondiente, o se rechaza con 401 (falla cerrada). Escucha en 127.0.0.1 por defecto; establezca MCP_HOST=0.0.0.0 (y colóquelo detrás de TLS/un proxy inverso) para exponerlo más allá de localhost.

Estructura del repositorio

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.

Notas

• Las llamadas de red bloqueantes (Azure OpenAI/Search, Cerner FHIR) se descargan con asyncio.to_thread para que una llamada lenta no detenga otras llamadas de herramientas en el mismo servidor.

• Los archivos SQLite (app/sar_foi.db, app/batch.db, app/dsar.db) se crean automáticamente en la primera ejecución y están en gitignore.