MedEval MCP (로컬)

비공개 MedEval 의료기기 규제 워크벤치를 위한 로컬 전용 Model Context Protocol 게이트웨이입니다.

MCP 클라이언트가 MedEval 워크스페이스, 정규화된 자료, 증거 검색, CEP/CER 생성 및 평가, 워크플로 관찰 가능성, 불변 문서 개정을 운영할 수 있게 합니다. MedEval은 시스템 오브 레코드로 유지되며, 이 프로젝트는 얇고 경계가 명확한 어댑터입니다.

안전 경계

• stdio 전송만 지원하며, 네트워크 MCP 리스너가 없음

• 기본적으로 루프백에 연결하며, 신뢰할 수 있는 사설 네트워크 IP에 대해서만 명시적 옵트인 지원

• 명시적 워크스페이스/작업 식별자

• 허용 목록에 등록된 로컬 업로드 루트

• 삭제, 셸, 배포, 비밀 관리 도구 없음

• 비동기 시작은 작업 ID를 반환하며, 중복이 아닌 폴링 방식으로 처리해야 함

• 제품 사실은 외부 문헌에서 도출할 수 없음

• 문서 편집에는 현재 base_revision_id가 필요함

SECURITY.md 참조.

요구 사항

• Windows 또는 기타 Python 3.11+ 환경

• http://127.0.0.1:8000에서 실행 중인 MedEval

• pyproject.toml의 Python 패키지 의존성

설치

cd C:\path\to\medeval-mcp
py -3.11 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e ".[test]"
Copy-Item .env.example .env

MCP 프로세스는 일반 환경 변수를 읽습니다. MCP 클라이언트는 일반적으로 .env를 자동으로 로드하는 대신 서버 구성에서 환경 변수를 제공합니다.

구성

최소 로컬 구성:

MEDEVAL_BASE_URL=http://127.0.0.1:8000
MEDEVAL_PROJECT_ROOT=C:\path\to\medeval
MEDEVAL_ALLOWED_FILE_ROOTS=C:\path\to\medeval;C:\path\to\materials

MedEval이 MEDEVAL_API_TOKEN을 활성화한 경우, 이 MCP 프로세스에 동일한 MEDEVAL_API_TOKEN을 제공하십시오. X-API-Token으로 전송됩니다. 서명된 브라우저/세션 토큰은 대신 MEDEVAL_BEARER_TOKEN으로 제공할 수 있습니다.

신뢰할 수 있는 LAN 백엔드에 연결하는 macOS 클라이언트

MedEval이 동일한 신뢰할 수 있는 LAN의 다른 컴퓨터에서 수신 대기 중인 경우, 해당 컴퓨터의 실제 사설 IP를 사용하고 명시적으로 옵트인하십시오:

MEDEVAL_BASE_URL=http://192.168.0.166:8001
MEDEVAL_ALLOW_PRIVATE_NETWORK=true
MEDEVAL_PROJECT_ROOT=/Users/your-name/MedEval
MEDEVAL_ALLOWED_FILE_ROOTS=/Users/your-name/MedEval:/Users/your-name/Documents

MCP는 Mac에서 로컬 stdio 프로세스로 유지됩니다. 공용 IP 주소와 도메인 이름은 여전히 거부됩니다.

Codex에서 연결

examples/codex.mcp.json을 MCP 서버 정의로 사용하십시오. 명령은 이 프로젝트의 .venv Python을 가리켜야 하며 다음을 사용해야 합니다:

-m medeval_mcp.server

MCP 구성을 변경한 후 Codex를 다시 시작하고 medeval_health를 호출하도록 요청하십시오.

수동 실행

MCP stdio는 프로토콜 메시지에 표준 출력을 사용하므로 수동 실행은 유휴 상태로 보입니다:

.\.venv\Scripts\python.exe -m medeval_mcp.server

MCP 클라이언트 또는 Inspector를 사용하여 상호 작용하십시오.

번들된 로컬 런처는 stdio를 시작하기 전에 루프백 백엔드와 업로드 루트를 설정합니다:

.\scripts\run_local.ps1

프로토콜 및 백엔드 스모크 테스트:

.\.venv\Scripts\python.exe scripts\mcp_smoke.py --health

도구 표면

첫 번째 릴리스는 21개의 도구를 제공합니다:

• 워크스페이스: 상태, 프로젝트 목록, 워크스페이스 생성/가져오기, 워크스페이스 문서

• 관찰 가능성: 실행 목록, 실행 세부 정보, 제한된 에이전트 컨텍스트

• 증거: 프로젝트 문서, 증거 검색, 섹션 컨텍스트

• 수집: 허용 목록에 등록된 로컬 자료 업로드 및 정규화

• 생성: 템플릿 목록, 생성 시작, 생성/작업 상태

• 평가: 평가 시작

• 개정: 목록, 제한된 읽기, 차이, 낙관적 잠금 패치

medeval_start_generation은 기본적으로 MedEval의 의존성 직렬 세그먼트 작성기를 사용하는 tag_index_agent로 설정됩니다. 전체 컨텍스트 전략은 옵트인 상태로 유지됩니다.

테스트

.\.venv\Scripts\python.exe -m pytest

테스트는 모의 HTTP 전송을 사용하며 LLM 생성을 시작하거나 모델 할당량을 소비하지 않습니다. 별도의 통합 스모크 테스트는 MCP 도구를 나열하고 이미 실행 중인 로컬 /api/health 엔드포인트를 호출합니다.

아직 포함되지 않음

• 원격 Streamable HTTP 전송

• xiaoyuu.me 배포

• 다중 사용자 API 키 및 워크스페이스 소유권

• 원격 업로드 스테이징

• 파괴적 프로젝트/작업 삭제