nhs-intelligence-mcp

Ein MCP-Server, der Tools für NHS-Wartezeiten und Trust-Intelligenz bereitstellt, damit ein agentischer Client (Claude Code, Claude Desktop oder ein beliebiger MCP-kompatibler Host) offene Fragen zur Leistung von NHS-Providern auf der Grundlage echter öffentlicher Daten beantworten kann.

Der Server stellt ausschließlich Daten- und Analysetools bereit; er ruft niemals ein LLM auf. Das agentische Denken findet im verbindenden Client statt, der diese Tools miteinander verkettet. Dadurch bleiben die Zahlen deterministisch und der gesamte Server offline unit-testbar.

Status

Meilenstein 3. Fünf Tools über drei Datenquellen: RTT-Trend, My Planned Care aktueller Stand (Suche und Ranking), CQC-Qualitätsbewertungen und ein kombiniertes trust_profile, das alle drei verbindet. Jedes ist Ende-zu-Ende mit einer Offline-Testsuite abgedeckt (57 Tests).

Hinweis zur Trust-Identität

Die drei Quellen benennen Trusts unterschiedlich: RTT verwendet einen numerischen Provider-Code (z. B. RGT), My Planned Care verwendet den Trust-Namen (z. B. Guy's and St Thomas'), CQC verwendet eine eigene Provider-ID (z. B. 1-101681210). Die Einzelquellen-Tools verwenden die Identität, die ihre Quelle veröffentlicht. trust_profile führt die drei anhand einer kuratierten Mapping-Datei zusammen; ein Trust, der in der Zuordnung fehlt, gibt found=false zurück. Bewertungsdaten sind ergänzend: Wenn der CQC-Feed nicht erreichbar ist, entfernt das Profil diesen einen Abschnitt und gibt weiterhin die Warte- und Trenddaten zurück.

Related MCP server: NHS MCP Server

Design

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

Der reine Kern (domain, analysis) hat keine Ein-/Ausgabe und keine MCP-Importe, sodass er in CI ohne Netzwerk und ohne Live-NHS-Feed läuft. Jede Quelle liegt hinter einem Protocol, einschließlich des CQC-HTTP-Clients, sodass Tests In-Memory-Fakes injizieren und die Suite vollständig offline ist. Dies ist die Ports-and-Adapter-Grenze aus nhs-webscraper, angewendet auf Datenfeeds.

Datenquellen

Tools

Die Trendrichtung wird durch eine relative Totzone (Standard: 5 %) bestimmt, sodass eine kleine Schwankung bei einer langen Wartezeit als flat gelesen wird und nicht als Scheintrend: dieselbe Entscheidung zur Rauschunterdrückung wie im MRR-prediction-Projekt. Das Ranking listet Trusts, die eine Fachrichtung veröffentlichen, aber keinen Wert angeben, nach den bereits sortierten Trusts auf, sodass Abdeckungslücken sichtbar bleiben und sich von einer Wartezeit von null unterscheiden.

Ausführen

Abhängigkeiten werden mit uv verwaltet und in uv.lock festgeschrieben; eine einfache requirements.txt wird zusätzlich exportiert, für alle, die kein uv verwenden.

# 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

Ohne uv: pip install -r requirements.txt ausführen und dann nhs-intel-mcp direkt starten, wobei dieselben Umgebungsvariablen gesetzt sind.

Nur NHS_INTEL_RTT_CSV ist erforderlich; jedes Tool meldet deutlich, wenn seine Quelle nicht konfiguriert ist, und der CQC-Feed degradiert bei Nichterreichbarkeit zu einem fehlenden Bewertungsabschnitt. .mcp.json registriert den Server für Claude Code über uv run, sodass die projekteigene Umgebung verwendet wird, unabhängig davon, welche in der aufrufenden Shell aktiv ist.

Entwicklung

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