MedEval MCP 서버

실행 중인 MedEval 의료기기 규제 작업 공간에 대한 인증된 Streamable HTTP MCP 액세스입니다.

공개 엔드포인트: https://xiaoyuu.me/mcp

이 서버는 Codex 호환 MCP 클라이언트에 MedEval 프로젝트 선택, 증거 검색, CEP/CER 섹션 컨텍스트, Agent 관찰 가능성, 생성/평가 작업 제어 및 불변 문서 개정을 제공합니다.

보안 모델

• 모든 MCP 요청에는 Authorization: Bearer <token>이 필요합니다.

• MCP 프로세스는 127.0.0.1에 바인딩되며, Nginx만 HTTPS로 노출합니다.

• 어댑터는 루프백 MedEval API만 호출할 수 있습니다.

• 삭제, 정리, 취소, 롤백 또는 임의 서버 파일 업로드 도구는 노출되지 않습니다.

• 액세스 토큰은 서버의 /etc/medeval-mcp.env에만 저장되며 절대 커밋해서는 안 됩니다.

• 이 배포는 하나의 공유 MedEval 인스턴스를 사용합니다. 토큰을 가진 사람은 누구나 해당 프로젝트를 검사하고 노출된 쓰기 도구를 호출할 수 있습니다. 테넌트 격리가 필요한 경우 별도의 배포/토큰을 사용하세요.

MedEval 자체는 서버 운영자가 구성한 모델 및 문헌 제공자를 계속 호출할 수 있습니다. MCP 어댑터가 비공개라고 해서 이러한 다운스트림 작업이 오프라인이라고 가정하지 마십시오.

Related MCP server: LLM Wiki Streamable HTTP MCP Server

Codex와 함께 사용하기

Codex는 베어러 토큰이 있는 Streamable HTTP MCP 서버를 지원합니다. config.toml이 아닌 환경 변수에 토큰을 넣으세요.

1. 토큰 설정

PowerShell:

$env:MEDEVAL_MCP_TOKEN = "the-token-provided-by-the-server-owner"

macOS/Linux:

export MEDEVAL_MCP_TOKEN='the-token-provided-by-the-server-owner'

2. Codex 구성

~/.codex/config.toml에 다음을 추가하세요:

[mcp_servers.medeval]
url = "https://xiaoyuu.me/mcp"
bearer_token_env_var = "MEDEVAL_MCP_TOKEN"
tool_timeout_sec = 1800
startup_timeout_sec = 30
default_tools_approval_mode = "writes"

ChatGPT 데스크톱 앱, Codex CLI 또는 IDE 확장을 다시 시작하세요. /mcp를 사용하여 medeval이 연결되었는지 확인하세요.

writes 승인 모드를 사용하면 생성, 평가, 작업 공간 생성 또는 문서 패치 전에 프롬프트를 표시하면서 읽기 전용 검사가 정상적으로 실행됩니다.

일반적인 워크플로

1. medeval_health를 호출하세요.

2. medeval_list_projects를 호출하세요. 작업 공간 또는 작업 ID를 추측하지 마세요.

3. 필요할 때 xiaoyuu.me를 통해 소스 자료를 업로드하세요. 원격 MCP는 의도적으로 클라이언트 컴퓨터의 경로를 읽을 수 없습니다.

4. 추적 가능한 검색을 위해 medeval_search_project_evidence 또는 medeval_build_section_context를 사용하세요.

5. 명시적 승인 후에만 생성/평가를 시작하고 반환된 작업 ID를 보관하세요.

6. 느린 작업을 무작정 다시 제출하지 말고 medeval_get_task_progress, medeval_list_runs 및 medeval_get_run을 검사하세요.

7. 편집의 경우 현재 개정을 읽고 base_revision_id로 패치한 다음 결과 diff를 확인하세요.

제품 사실은 업로드된 제품 자료에서 가져와야 합니다. 외부 문헌은 보조 증거이며 의도된 용도, 적응증, 사양, 위험 또는 테스트 결과를 조용히 대체해서는 안 됩니다.

사용 가능한 도구

읽기 전용 도구:

• medeval_health

• medeval_list_projects

• medeval_get_workspace

• medeval_list_workspace_documents

• medeval_list_runs

• medeval_get_run

• medeval_get_agent_context

• medeval_list_project_documents

• medeval_search_project_evidence

• medeval_build_section_context

• medeval_list_generation_templates

• medeval_get_task_progress

• medeval_get_generation_task

• medeval_list_document_revisions

• medeval_read_document_revision

• medeval_diff_document_revisions

비파괴 쓰기 도구:

• medeval_create_workspace

• medeval_start_generation

• medeval_start_evaluation

• medeval_patch_document_revision

자체 인스턴스 실행

요구 사항:

• Python 3.11+

• 동일 호스트에서 접근 가능한 MedEval FastAPI 백엔드

• 공개 사용을 위한 HTTPS 리버스 프록시

git clone https://github.com/hanxiaoyu-cmd/medeval-mcp-server.git
cd medeval-mcp-server
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e .
cp .env.example .env

.env에서 변수를 내보낸 다음 실행하세요:

python -m medeval_mcp_server

기본 리스너는 127.0.0.1:8765이며, MCP 경로는 /mcp이고 공개 상태 확인 경로는 /healthz입니다.

프로덕션 배포

예제 systemd 및 Nginx 파일은 deploy/ 아래에 있습니다:

• medeval-mcp.service는 권한이 없는 강화된 프로세스를 실행합니다.

• nginx-location.conf는 버퍼링 없이 /mcp를 프록시하고 긴 도구 호출을 유지합니다.

다음으로 토큰을 생성하세요:

python -c 'import secrets; print(secrets.token_urlsafe(36))'

루트가 읽을 수 있는 환경 파일에 저장하세요:

MEDEVAL_MCP_TOKEN=<generated-token>
MEDEVAL_API_BASE_URL=http://127.0.0.1:8000
MEDEVAL_MCP_PUBLIC_HOSTS=your-domain.example,127.0.0.1,localhost

파일 모드를 600으로 설정하고 nginx -t로 Nginx를 검증한 다음, 토큰을 공유하기 전에 인증되지 않은 거부와 인증된 MCP 초기화를 모두 확인하세요.

개발

python -m pip install -e ".[dev]"
python -m pytest
python -m compileall -q src

라이선스

MIT