MedEval MCP Server

Аутентифицированный доступ к работающему MedEval — рабочему пространству для регулирования медицинских устройств — через Streamable HTTP MCP.

Публичная конечная точка: https://xiaoyuu.me/mcp

Сервер предоставляет MCP-клиентам, совместимым с Codex, выбор проекта MedEval, поиск доказательств, контекст разделов CEP/CER, наблюдаемость агента, управление задачами генерации/оценки и неизменяемые ревизии документов.

Модель безопасности

• Каждый MCP-запрос требует Authorization: Bearer <token>.

• Процесс MCP привязан к 127.0.0.1; только Nginx предоставляет его через HTTPS.

• Адаптер может вызывать только API MedEval через loopback.

• Не предоставляются инструменты для удаления, очистки, отмены, отката или произвольной загрузки файлов на сервер.

• Токен доступа хранится только в /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; никогда не угадывайте идентификатор рабочего пространства или задачи.

3. Загрузите исходные материалы через xiaoyuu.me, когда это необходимо. Удаленный MCP намеренно не может читать пути на клиентском компьютере.

4. Используйте medeval_search_project_evidence или medeval_build_section_context для отслеживаемого поиска.

5. Запускайте генерацию/оценку только после явного разрешения и сохраняйте возвращенный идентификатор задачи.

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))'

Сохраните его в файле окружения, доступном для чтения root:

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 с помощью nginx -t и убедитесь как в отклонении неаутентифицированных запросов, так и в аутентифицированной инициализации MCP перед передачей токена.

Разработка

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

Лицензия

MIT