Universal MCP Lab

Минимальная проверка концепции для валидации динамического приобретения возможностей за стабильной поверхностью MCP.

Гипотеза

Агент начинает с шести стабильных инструментов. Подключает сервис OpenAPI, обнаруживает новые внутренние возможности, проверяет их и вызывает их, не изменяя опубликованный каталог MCP.

Предусмотренная стабильная поверхность:

• services.connect

• services.disconnect

• services.list

• capabilities.list

• capabilities.describe

• capabilities.invoke

PoC не даёт прямого доступа к компьютеру, не открывает произвольную оболочку и не хранит учётные данные.

Related MCP server: openapi-mcp

Запуск локального теста

python -m unittest discover -s tests -v
python scripts/demo.py

Настоящий MCP через stdio

Фаза 3 включает настоящий сервер MCP с шестью стабильными инструментами. Установите объявленную зависимость и позвольте хосту MCP запустить процесс:

pip install -e .
python -m entradas.mcp.server

Процесс не показывает интерфейс и не должен писать в stdout: он ожидает сообщения MCP через stdin. Тест tests/test_mcp_protocol.py действует как настоящий клиент MCP, проверяет tools/list, подключает синтетический OpenAPI и подтверждает, что публичный каталог не меняется.

Этот локальный транспорт намеренно ограничен: он не публикует HTTP, не включает OAuth, не подключает ПК и не включает одобрения на запись.

Чтобы включить HTTP-чтение в лаборатории, настройте перед запуском локальный список разрешений. Документ OpenAPI, отправленный через MCP, не может изменить этот адрес:

$env:UNIVERSAL_MCP_READ_BASE_URLS = '{"customers":"https://api.example.test"}'
python -m entradas.mcp.server

Выполняются только GET к настроенным сервисам; есть таймаут, ограничение размера, обязательный JSON, без перенаправлений и повторных попыток. Набор тестов не использует Интернет: он поднимает временную локальную конечную точку для проверки этого потока.

Локальный узел владельца

Узел ПК — это отдельный локальный процесс MCP, а не функция удалённого управления. Только владелец компьютера может запустить его и указать явную папку:

$env:UNIVERSAL_MCP_OWNER_ALLOWED_ROOT = 'C:\carpeta-autorizada'
python -m entradas.pc_node.server

Его единственный инструмент — pc.read_text(relative_path). Он не включает оболочку, запись, просмотр диска, браузер, процессы или сетевые слушатели. Туннель и аутентификация между шлюзом и этим узлом относятся к более поздней фазе.

Action Boundary для записей

Запись не принимает approved=true. Первый запрос возвращает ссылку на подтверждение; доверенный человеческий интерфейс должен одобрить именно это действие вне MCP. Полученная авторизация одноразовая, привязана к тем же аргументам и расходуется до исполнителя. Это пока не включает запись на узле ПК.

Статус

Архитектура + ядро лаборатории + глубокий ECA подготовлены. См. STATUS.md и docs/PLAYBOOK.md.