nhs-intelligence-mcp

Un servidor MCP que expone herramientas de tiempos de espera y de inteligencia sobre trusts del NHS, de modo que un cliente agéntico (Claude Code, Claude Desktop o cualquier host compatible con MCP) pueda responder preguntas abiertas sobre el rendimiento de los proveedores del NHS basándose en datos públicos reales.

El servidor expone únicamente herramientas de datos y análisis; nunca llama a un LLM. El razonamiento agéntico ocurre en el cliente conectado, que encadena estas herramientas. Esto mantiene los números deterministas y todo el servidor comprobable mediante pruebas unitarias sin conexión.

Estado

Hito 3. Cinco herramientas sobre tres fuentes de datos: tendencia RTT, estado actual de My Planned Care (consulta y clasificación), calificaciones de calidad CQC y un trust_profile combinado que une las tres. Cada una está completa de extremo a extremo con una suite de pruebas sin conexión (57 pruebas).

Una nota sobre la identidad de los trusts

Las tres fuentes nombran a los trusts de forma diferente: RTT usa un código de proveedor numérico (p. ej., RGT), My Planned Care usa el nombre del trust (p. ej., Guy's and St Thomas'), CQC usa su propio id de proveedor (p. ej., 1-101681210). Las herramientas de una sola fuente toman la identidad que publica su fuente. trust_profile concilia las tres a partir de un archivo de mapeo curado; un trust que no esté en el mapeo devuelve found=false. Los datos de calificación son complementarios: si el feed de CQC no está disponible, el perfil omite esa sección y aun así devuelve los datos de espera y de tendencia.

Related MCP server: NHS MCP Server

Diseño

src/nhs_intel/
  domain/      # immutable value objects (WaitTimePoint, TrustRating, ...)
  sources/     # adapters behind Protocols (CSV feeds, CQC HTTP, identity map)
  analysis/    # pure trend, ranking and profile-join logic
  server.py    # thin FastMCP layer: validate -> pure handler -> serialise

El núcleo puro (domain, analysis) no tiene E/S ni imports de MCP, por lo que se ejecuta en CI sin red y sin feed en vivo del NHS. Cada fuente se encuentra detrás de un Protocol, incluido el cliente HTTP de CQC, por lo que las pruebas inyectan fakes en memoria y la suite es completamente offline. Este es el límite de puertos y adaptadores de nhs-webscraper, aplicado a los flujos de datos.

Fuentes de datos

Herramientas

La dirección de la tendencia se decide mediante una banda muerta relativa (5 % por defecto), de modo que una pequeña fluctuación en una espera larga se lee como flat en lugar de una tendencia espuria: la misma elección de supresión de ruido realizada en el proyecto MRR-prediction. La clasificación enumera los trusts que publican una especialidad pero sin cifra después de los clasificados, manteniendo las lagunas de cobertura visibles y distintas de una espera de cero.

Ejecución

Las dependencias se gestionan con uv y se bloquean en uv.lock; junto a él se exporta un requirements.txt simple para quien no tenga uv.

# uv resolves and creates .venv automatically from uv.lock:
uv sync --extra dev

# Point the server at an ingested RTT CSV cache (provider_code,specialty,weeks,as_of):
export NHS_INTEL_RTT_CSV=tests/fixtures/rtt_sample.csv

# Optional: My Planned Care scraper output for the current-state tools.
export NHS_INTEL_PLANNED_CARE_CSV=tests/fixtures/planned_care_sample.csv

# Optional: cross-source identity mapping for trust_profile.
export NHS_INTEL_IDENTITY_CSV=tests/fixtures/identity_sample.csv

# Optional: a partnerCode string sent with CQC requests to identify your caller.
export NHS_INTEL_CQC_PARTNER_CODE=my-org

# Run the MCP server over stdio:
uv run nhs-intel-mcp

Sin uv: pip install -r requirements.txt y luego ejecute nhs-intel-mcp directamente, con las mismas variables de entorno configuradas.

Solo se requiere NHS_INTEL_RTT_CSV; cada herramienta informa claramente cuando su fuente no está configurada, y el feed de CQC se degrada a una sección de calificación ausente cuando no es accesible. .mcp.json registra el servidor para Claude Code usando uv run, de modo que se usa el entorno propio del proyecto independientemente de lo que esté activo en la shell que realiza la llamada.

Desarrollo

uv sync --extra dev
uv run pytest    # offline, no network or keys required
uv run ruff check .