nhs-intelligence-mcp

NHS 대기 시간 및 트러스트 인텔리전스 도구를 노출하는 MCP 서버로, 에이전트 클라이언트(Claude Code, Claude Desktop 또는 MCP 호환 호스트)가 실제 공개 데이터에 근거하여 NHS 제공자 성과에 대한 개방형 질문에 답할 수 있게 합니다.

서버는 데이터 및 분석 도구만 노출하며 LLM을 호출하지 않습니다. 에이전트 추론은 이러한 도구를 연결하는 클라이언트에서 이루어집니다. 이를 통해 숫자는 결정적이며 서버 전체를 오프라인에서 단위 테스트할 수 있습니다.

상태

마일스톤 3. 세 가지 데이터 소스에 걸친 다섯 가지 도구: RTT 추세, My Planned Care 현재 상태(조회 및 순위), CQC 품질 등급, 그리고 세 가지를 모두 결합한 trust_profile입니다. 각각은 오프라인 테스트 스위트(57개 테스트)로 종단 간 검증됩니다.

트러스트 식별에 관한 참고 사항

세 소스는 트러스트를 서로 다르게 명명합니다. RTT는 숫자 제공자 코드(예: RGT)를 사용하고, My Planned Care는 트러스트 이름(예: Guy's and St Thomas')을 사용하며, CQC는 자체 제공자 ID(예: 1-101681210)를 사용합니다. 단일 소스 도구는 해당 소스가 공개하는 식별자를 사용합니다. trust_profile은 큐레이션된 매핑 파일을 사용해 세 가지를 하나로 결합하며, 매핑에 없는 트러스트는 found=false를 반환합니다. 등급 데이터는 보조적입니다. CQC 피드에 연결할 수 없으면 프로필은 해당 섹션 하나를 제외하고도 대기 및 추세 데이터를 계속 반환합니다.

Related MCP server: NHS MCP Server

설계

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의 포트-어댑터 경계를 데이터 피드에 적용한 것입니다.

데이터 소스

도구

추세 방향은 상대적 불감대(기본 5%)로 결정되므로 긴 대기 시간의 작은 흔들림은 가짜 추세가 아닌 flat으로 읽힙니다. 이는 MRR-prediction 프로젝트에서 적용한 것과 동일한 노이즈 억제 선택입니다. 순위 목록은 전문 분야를 게시하지만 수치가 없는 트러스트를 순위가 매겨진 트러스트 뒤에 배치하여, 커버리지 공백이 드러나고 0 대기 시간과는 구별되도록 합니다.

실행

의존성은 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용 서버를 등록하므로 호출 셸에서 활성화된 환경과 관계없이 프로젝트 자체 환경이 사용됩니다.

개발

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