nhs-intelligence-mcp

NHSの待ち時間とトラスト情報のツールを公開するMCPサーバー。エージェント型クライアント（Claude Code、Claude Desktop、その他MCP互換ホスト）が、実際の公開データに基づいてNHSプロバイダーのパフォーマンスに関する自由形式の質問に答えられるようにします。

このサーバーが公開するのはデータおよび分析ツールのみで、LLMを呼び出すことは一切ありません。エージェント型の推論は接続しているクライアント側で行われ、クライアントがこれらのツールを連鎖させます。これにより数値は決定的になり、サーバー全体をオフラインで単体テストできます。

Status

マイルストーン3。3つのデータソースにわたる5つのツール：RTTトレンド、My Planned Careの現状（検索とランキング）、CQC品質評価、そして3つすべてを結合したtrust_profile。それぞれがエンドツーエンドで、オフラインのテストスイート（57テスト）を備えています。

トラストの識別について

3つのソースはトラストの識別方法が異なります。RTTはプロバイダーコード（例：RGT）を使用し、My Planned Careはトラスト名（例：Guy's and St Thomas'）を使用し、CQCは独自のプロバイダーID（例：1-101681210）を使用します。単一ソースのツールは、各ソースが公開している識別子を使用します。trust_profileは、厳選されたマッピングファイルから3つを照合します。マッピングに存在しないトラストはfound=falseを返します。評価データは補足的なものです。CQCフィードに到達できない場合、プロファイルはそのセクションだけを除外し、待ち時間とトレンドのデータは引き続き返します。

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

純粋なコア（domain、analysis）にはI/Oがなく、MCPのインポートもないため、ネットワークなし、ライブのNHSフィードなしでCIで実行できます。CQC HTTPクライアントを含むすべてのソースはProtocolの背後に配置されているため、テストはインメモリのフェイクを注入でき、スイートは完全にオフラインで動作します。これはnhs-webscraperのポート・アダプター境界をデータフィードに適用したものです。

Data sources

Tools

トレンドの方向は相対的な不感帯（デフォルト5%）で判定されるため、長い待ち時間における小さな変動は、見せかけのトレンドではなくflatとして読み取られます。これはMRR予測プロジェクトで行ったノイズ抑制と同じ選択です。ランキングでは、専門分野を公開していても数値がないトラストを、ランク付けされたものの後ろにリストし、カバレッジのギャップが見えるようにしつつ、待ち時間ゼロとは区別します。

Running

依存関係はuvで管理され、uv.lockにロックされています。uvを持っていない人向けに、プレーンなrequirements.txtも併せてエクスポートされています。

# 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

uvを使わない場合：pip install -r requirements.txtを実行し、同じ環境変数を設定してnhs-intel-mcpを直接実行します。

必要な環境変数はNHS_INTEL_RTT_CSVだけです。各ツールはソースが未設定の場合に明確に報告し、CQCフィードは到達不能な場合、評価セクションを欠落させた状態に縮退します。.mcp.jsonはuv runを使用してClaude Code用にサーバーを登録するため、呼び出し元シェルで何がアクティブであっても、プロジェクト自身の環境が使用されます。

Development

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