MCP Server Healthcare

NHS 임상 코딩 워크플로우를 위한 Model Context Protocol(MCP) 서버 — 임상 기록에 대한 ICD-10-CM/OPCS-4/HCC 코드 제안, SAR/FOI 정보 거버넌스 요청 추적, DSAR 매핑 저장소 요청을 분류 및 임상 검토로 처리, 일괄 코딩, Cerner FHIR R4 샌드박스를 통한 환자 데이터 읽기/쓰기.

모든 MCP 클라이언트(Claude Desktop, Claude Code, Copilot Studio의 MCP 커넥터 등)가 REST API 계층 없이 이러한 도구를 직접 호출할 수 있습니다.

원래 bobbynoble/clinical-coding-bot의 일부로 구축되었습니다. 이 저장소는 독립형 MCP 서버로, 래핑하는 비즈니스 로직의 자체 사본을 포함하므로 해당 저장소에 대한 의존성이 없습니다.

도구

cerner_post_condition, cerner_post_procedure 및 cerner_writeback_episode는 구성된 Cerner 환경(기본적으로 비프로덕션 샌드박스 — app/fhir_cerner.py 참조)에 대해 실제 쓰기를 수행합니다.

Related MCP server: fhir-synthetic-mcp

설정

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

어떤 자격 증명이 설정되어 있든 모든 도구가 로드되지만, suggest_clinical_codes는 Azure OpenAI + Azure AI Search가 구성되어 있어야 하고, cerner_* 도구는 CERNER_CLIENT_ID/CERNER_CLIENT_SECRET이 필요합니다. 일치하는 자격 증명 없이 호출하면 서버가 충돌하는 대신 명확한 오류와 함께 실패합니다.

실행

Stdio(Claude Desktop, Claude Code, 대부분의 로컬 MCP 클라이언트):

python -m MCP_Server_Healthcare

Claude Desktop 구성 예시(claude_desktop_config.json):

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

Streamable HTTP(원격 액세스, 예: Copilot Studio 또는 호스팅된 MCP 클라이언트에서):

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

HTTP 전송은 .env에 CODING_API_KEY가 설정되어 있어야 합니다. 모든 요청은 일치하는 X-API-Key 헤더를 포함해야 하며, 그렇지 않으면 401로 거부됩니다(기본 거부). 기본적으로 127.0.0.1에서 수신 대기하며, localhost 밖으로 노출하려면 MCP_HOST=0.0.0.0으로 설정하고(TLS/리버스 프록시 뒤에 배치) 사용하세요.

저장소 구조

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.

참고 사항

• 차단 네트워크 호출(Azure OpenAI/Search, Cerner FHIR)은 asyncio.to_thread로 오프로드되어 느린 호출 하나가 같은 서버의 다른 도구 호출을 지연시키지 않습니다.

• SQLite 파일(app/sar_foi.db, app/batch.db, app/dsar.db)은 첫 실행 시 자동으로 생성되며 gitignore에 포함됩니다.