MedEval MCP (локальный)

Локальный шлюз Model Context Protocol для частной рабочей среды MedEval по регулированию медицинских изделий.

Он позволяет MCP-клиенту работать с рабочими пространствами MedEval, канонизированными материалами, поиском доказательств, генерацией и оценкой CEP/CER, наблюдаемостью рабочих процессов и неизменяемыми ревизиями документов. MedEval остаётся системой записи; этот проект — тонкий ограниченный адаптер.

Границы безопасности

• только stdio-транспорт; без сетевого MCP-слушателя

• по умолчанию подключается к loopback, с явным согласием для доверенных IP-адресов частной сети

• явные идентификаторы рабочих пространств и задач

• разрешённые локальные корни загрузки

• нет инструментов удаления, shell, развёртывания или управления секретами

• асинхронные запуски возвращают идентификаторы задач и должны опрашиваться, а не дублироваться

• факты о продукте не могут быть получены из внешней литературы

• редактирование документов требует текущего base_revision_id

См. SECURITY.md.

Требования

• Windows или другое окружение с Python 3.11+

• MedEval, работающий на http://127.0.0.1:8000

• зависимости Python из pyproject.toml

Установка

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.

macOS-клиент к доверенному LAN-бэкенду

Когда 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 остаётся локальным stdio-процессом на Mac. Публичные IP-адреса и доменные имена по-прежнему отклоняются.

Подключение из Codex

Используйте examples/codex.mcp.json как определение MCP-сервера. Команда должна указывать на Python из .venv этого проекта и использовать:

-m medeval_mcp.server

Перезапустите Codex после изменения конфигурации MCP, затем попросите его вызвать medeval_health.

Запуск вручную

MCP stdio использует стандартный вывод для сообщений протокола, поэтому ручной запуск выглядит бездействующим:

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

Используйте MCP-клиент или Inspector для взаимодействия с ним.

Встроенный локальный лаунчер устанавливает loopback-бэкенд и корни загрузки перед запуском stdio:

.\scripts\run_local.ps1

Проверка протокола и бэкенда:

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

Поверхность инструментов

Первый выпуск предоставляет 21 инструмент:

• рабочее пространство: health, список проектов, создание/получение рабочего пространства, документы рабочего пространства

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

• доказательства: документы проекта, поиск доказательств, контекст раздела

• приёмка: загрузка и канонизация локальных материалов из разрешённых корней

• генерация: список шаблонов, запуск генерации, статус генерации/задачи

• оценка: запуск оценки

• ревизии: список, ограниченное чтение, diff, патч с оптимистичной блокировкой

medeval_start_generation по умолчанию использует tag_index_agent, который применяет зависимо-серийный сегментированный писатель MedEval. Стратегии с полным контекстом остаются опциональными.

Тесты

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

Тесты используют mock HTTP-транспорты и не запускают генерацию LLM и не расходуют квоту модели. Отдельный интеграционный смоук-тест перечисляет MCP-инструменты и вызывает уже работающий локальный эндпоинт /api/health.

Пока не включено

• удалённый Streamable HTTP-транспорт

• развёртывание на xiaoyuu.me

• многопользовательские API-ключи и владение рабочими пространствами

• удалённая промежуточная загрузка

• разрушительное удаление проектов/задач