Инструменты MCP

Текущий стабильный выпуск Bee предоставляет локальный stdio-сервер MCP. Запускайте bee mcp serve в нужном checkout; MCP-клиент создаёт процесс и обменивается JSON-RPC через stdio. bee mcp serve --discovery открывает компактные поиск/схему/вызов для того же фиксированного каталога. Четыре инструмента чтения дизайна/визуальных данных находятся в отдельном bee design mcp --stdio --root /absolute/path/to/checkout. После обновления Bee перезапустите долгоживущий процесс; bee --version должен соответствовать документации.

Основной сервер фиксирует checkout и выбранный экземпляр Bee при запуске. Для чтения навыков нужны инициализированный Bee и настроенный skill bridge. Для чтения планов требуется существующая живая привязка native-сессии сотрудничества; MCP-сервер не присоединяется, не claim’ит шаг и не запускает агента. Пакеты контекста и локальные артефакты могут читаться офлайн. CLI должен сохранять артефакты в artifacts корня выбранного экземпляра, чтобы их видел MCP. Ошибка бюджета означает, что частичное доказательство не было выдано. Предел кадра JSON-RPC — 512 КиБ, результата инструмента — 256 КиБ. Возвращённый код/текст навыка — данные, а не полномочие или доказательство чтения агентом.

Инструмент	Результат	Эффект и основное ограничение
bee_skill_search	Совпадения по query, limit 1–20	Только чтение; нужен bridge. Результат не является квитанцией чтения.
bee_skill_get	Одно полное тело навыка по path	Только чтение; не разрешает зависимости. Более 256 КиБ — ошибка.
bee_skill_resolve	Полная цепочка по path, зависимости первыми	Только чтение; отсутствующее/слишком большое тело — ошибка. Прочитайте все тела.
bee_plan_show	Точный planId текущего checkout/space	Только чтение; повторно проверяет привязку, не join/refresh.
bee_plan_next	Готовые шаги planId, limit 1–5	Только чтение; hasMore/число пропусков показывают предел. Не claim’ит шаг.
bee_context_packet	Выбранный пакет исходников из manifestJson	Только чтение; офлайн, без графа/провайдера. budgetBytes 512–262144 охватывает весь результат.
bee_artifact_search	Буквальные совпадения строк в артефактах	Только чтение; text, limit, offset, budgetBytes; подсчёт до пагинации.
bee_artifact_query	Фильтрованные/проецированные строки JSON	Только чтение; id, queryJson ≤64 КиБ, budgetBytes; код/SQL не исполняются.
bee_artifact_read	Страницы base64 проверенных точных байтов	Только чтение; id, offsetBytes, lengthBytes 1–65536. Соберите и проверьте sourceSha256.
bee_representation_encode	Полный пакет bee-json-v1 для json	Только чтение; encoding, budgetBytes; значения/запись чисел сохранены, пробелы/порядок — нет.
bee_representation_decode	Полные JSON-значения из packet	Только чтение; ограниченное раскрытие. Большой результат — ошибка без обрезки.
bee_context_compress	Необязательное локальное сжатие текста	Возможна локальная запись оригинала/метаданных. Сжатие включено, contentKind: "prose", ratePercent 10–90.
bee_compression_recover	Точный оригинал и проверенный sha256	Только чтение; оригинал должен быть в этом экземпляре; действует budgetBytes.
bee_design_list	ID, состояния, зависимости импортированного пакета	Только чтение в фиксированном checkout; без полной HTML-выдачи. bundle относительно корня хоста.
bee_design_slice	Контекст источника/зависимостей для одного id	Только чтение; budgetBytes 512–65536. complete: false — недостаточный контекст.
bee_design_verify	Целостность хешей, зависимостей и mapping	Только чтение; не сравнение скриншотов и не утверждение дизайна.
bee_visual_report	Оценка существующей спецификации/доказательства	Только чтение; браузер не запускается. Доказательство вызывающего недоверенное, acceptance: false.

Последние четыре доступны через bee design mcp --stdio --root /absolute/path/to/checkout, остальные 13 — через основной bee mcp serve. Для импорта/визуальной настройки см. сценарий дизайна. Изменение исходников, design import/map, снимок браузера, настройка/установка сжатия, добавление артефактов, вызов провайдера и запись плана — операции CLI, не MCP-инструменты.

Вызов пакета исходников

Передайте JSON-манифест выбора строковым аргументом manifestJson. У каждого выбора есть id, относительный к репозиторию path, representation (index, outline или body), необязательные symbol/range/hash, required и dependsOn. Выбирайте только нужное задаче:

{
  "selections": [
    {"id": "entry", "path": "src/Bee/Program.cs", "representation": "outline", "required": true}
  ]
}

Вызовите bee_context_packet с сериализованным объектом и budgetBytes: 32768. Хост применяет 15-секундный предел и возвращает needs_refinement, если обязательные данные или метаданные не помещаются. Сузьте выбор или увеличьте допустимый бюджет; пропущенное обязательное содержимое не считайте прочитанным. Соответствующий CLI описан в инструментах контекста и провайдеров.

Восстановление точных байтов артефакта

Вызовите bee_artifact_read с id из artifact add. Начните с offsetBytes: 0 и следуйте nextOffsetBytes до null. Ответ содержит id, sourceSha256, sourceBytes, offsetBytes, nextOffsetBytes, base64. Декодируйте и соберите страницы в порядке offset, затем сравните SHA-256 с sourceSha256. MCP не пишет файл; CLI artifact get может создать новый файл, если это явно нужно.

Эффекты и границы доверия

Шестнадцать инструментов, кроме bee_context_compress, помечены «только чтение». Сжатие способно сохранить оригинал с проверяемым хешем и локальные метаданные, поэтому помечено как запись. Выключенное сжатие возвращает оригинал. Ограничение — 64 КиБ/8192 локальных токенов; скрытой установки/скачивания/облака нет, а выход с потерями всегда несёт semanticRisk: true. Сравните оригинал через compression recover.

MCP-хост дизайна принимает только пути внутри фиксированного корня. Ответы design list/slice/verify содержат schemaVersion, ok, data или error, trusted: false, acceptance: false. bee_visual_report вместо этого возвращает диагностическую оценку с decision, findings, limitations, trusted: false, acceptance: false. Успешное чтение целостности не является утверждением дизайна. Инструменты навыков читают внешний настроенный bridge и поэтому отмечены open-world. Чтение плана показывает отчёт владельца; reported_complete не является независимой QA-приёмкой. Успешный вызов доказывает лишь результат данного чтения или локальной операции; итог задачи проверяйте по реальным файлам, процессам и тестам.