Студия в отдельном чате Hermes

Адаптер даёт Hermes доступ к приватной рабочей студии через MCP. Hermes сам пишет промпты, сценарии и разборы в своём чате. Сервер предоставляет проектный контекст, навыки и исследования, сохраняет результаты, ведёт задачи и проверяет выдачу. Он не вызывает генераторы, не покупает подписки, не публикует и не отправляет сообщения.

Видеопромпт сам по себе — допустимый результат проекта. Если видео не создавалось, это явно записывается в brief, выдаче и QA.

Запуск

Нужны POSIX-система (Linux/macOS), Python 3.10+ и официальный пакет mcp. На проверенном сервере Hermes уже есть Python 3.14.9 и mcp==2.3.0; дополнительная установка там не нужна. В SDK 2 используется MCPServer. Совместимый импорт FastMCP предусмотрен только для SDK 1.

/opt/hermes/.venv/bin/python /ABSOLUTE/PRIVATE/STUDIO/integrations/hermes-mcp/server.py --root /ABSOLUTE/PRIVATE/STUDIO

Замените оба пути на одну приватную папку студии. Это stdio-процесс: Hermes запускает его сам; отдельный HTTP-порт, домен и открытый сервер не нужны. Без --root используется папка студии двумя уровнями выше адаптера. Root фиксируется при запуске и не передаётся в инструменты. Путь и каждый его предок должны быть обычными папками без symlink; используйте физический путь.

Для отдельной локальной среды:

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt

Это инструкция, не выполненная установщиком покупка или изменение окружения Hermes. SDK: официальный репозиторий. Данные студии и конфигурация MCP должны оставаться вне публичной папки сайта.

Инструменты

Raw name	Назначение
`studio_status`	Проекты, стадии и доступные имена секций/модулей
`search_knowledge`	Поиск по `tools`, `economy`, `posts`, `guides`; максимум 10 результатов
`get_guidance`	Один из 10 навыков, AGENTS/SOP или фиксированный контекст вкуса
`create_project`	Новый проект с title и brief; существующий проект не перезаписывается
`read_project`	Секция, её SHA256 и revision всего проекта
`save_document`	Текстовый документ с проверкой SHA, атомарной заменой и историей
`project_tasks`	Добавить/прочитать/изменить задачу; зависимости проверяет CLI
`prompt_context`	Контекст для image/video/text, память вкуса и реестр инструментов
`review_project`	Причины keep/reject/revise или содержательная QA с provenance
`set_project_stage`	Стадия с проверкой; `ready` требует текущую QA и законченные задачи
`project_delivery`	Структурная проверка или приватный ZIP через существующий CLI
`project_budget`	Бюджет и фактические расходы; cap никогда не увеличивается

Дополнительно доступны ресурс studio://capabilities, шаблон ресурса studio://guidance/{module} и MCP prompt studio_prompt(slug, target_kind). Основной интерфейс — tools: они работают и в клиентах без поддержки ресурсов/промптов.

Каждый инструмент возвращает ok: true и result либо ok: false и error. Ошибка conflict означает: перечитать документ/проект и сверить изменения, а не повторять старую запись вслепую.

Разрешённые документы

save_document и read_project принимают имена, а не пути:

brief, meaning, decisions, journal, research, constraints;
canon → world/bible.md, world_records, world_continuity;
shotlist, prompts, feedback — рабочие материалы;
post, script, video_prompts, portfolio_case, delivery_readme — выдача;
sources — проверяемый JSON-массив research/sources.json.

Для sources обязательны строковые поля id, title, url, accessed, tier, claim, boundary, provenance; ID уникальны, tier — A/B/C/D, URL — HTTP(S) без учётных данных. Это сохранение ссылок, без перехода по ним.

Только чтение: project, tasks, budget, costs, metrics, radar, qa, qa_metadata, feedback_log. Прямой записи project.json, QA, очереди и бюджета нет.

get_guidance знает все имена из studio_status.guidance_modules, в том числе agents, profile, taste, lessons, studio-decisions, 10 studio-* skills и SOP. Произвольный путь, vendor-код, секреты и конфигурация клиента не выдаются.

Цикл работы Hermes

Прочитать agents, profile, taste, studio-decisions. Создать проект или выбрать существующий.
Получить prompt_context. Он включает brief, смысл, канон, ограничения, кадры, решения, рабочий feedback, последние структурированные отзывы и ограниченный контекст вкуса. Список truncated_sections отмечает сокращения; полный текст читается отдельно.
Написать один рекомендуемый промпт в чате. Альтернативы нужны лишь когда помогают выбору. При отсутствии генератора подготовить переносимый текст и не заявлять проверку на модели.
Сохранить результат через save_document. Для существующего документа сначала получить sha256 через read_project; для нового expected_sha256 не нужен. Лимит текста — 256 KiB.
При необходимости сохранить отзыв или провести QA. Для feedback: items: [{target, decision, reason}]. target — kind документа или существующий артефакт внутри deliverables; причина обязательна.
Для QA передать пять checks: brief_alignment, facts_and_sources, rights_and_privacy, craft, delivery, каждый с status и конкретным evidence. Статусы: pass, fail, not_applicable; соответствие brief, качество и выдачу исключать нельзя. Дополнительно передать ограничения.
После завершения задач установить ready и собрать package. Промпт можно сохранить и выдать пользователю ещё до упаковки.

review_project, смена стадии, task set, package и record_fact требуют актуальный expected_revision. Любая значимая правка после QA делает её устаревшей. Самопроверка агента обозначается agent_self_review; она не выдаётся за независимое мнение. provenance=user требует source_ref на реальный отзыв, но сервер не удостоверяет личность автора: это явно отмечено в метаданных.

Механические границы

Файлы открываются относительно фиксированного root через descriptor-relative операции с O_NOFOLLOW. Ссылки в любом читаемом предке, symlink/hardlink выдачи, специальные и скрытые файлы экспорта отвергаются. Разрешены ограниченные текстовые секции и обычные форматы артефактов; максимальный файл выдачи — 32 MiB, весь набор — 100 MiB, до 300 файлов. Публичный сайт не является рабочей студией.

Изменения сериализуются файловой блокировкой; SHA/revision защищают от потерянных обновлений между MCP-клиентами. Текстовые записи атомарны, прошлый текст хранится в .hermes/versions/. Блокировка не управляет произвольным внешним редактором: не редактируйте одновременно те же файлы через старый CLI или вручную. Несколько файлов одной CLI-операции фиксируются последовательно; это не транзакционная база данных с восстановлением после сбоя питания.

Доверенный studio.py импортируется в изолированной временной копии проекта. Набор функций фиксирован; shell, subprocess, сеть и выполнение проектного/vendor-кода отсутствуют. ZIP включает только brief, QA, project metadata и deliverables; внутренние контекст, исследования и история не экспортируются. Фактический расход выше cap можно записать честно, но запись ничего не оплачивает и не разрешает дальнейшие траты.

Проверка

python3 -m unittest discover -s integrations/hermes-mcp/tests -v

Запуск из корня студии. Тесты работают на временных копиях без MCP SDK, сети и генерации. Они проверяют полный prompt-only цикл до ZIP и его хеши, устаревшую QA, конкурирующие записи, границы путей/ссылок/размера, задачи, источники, бюджет и наличие канона/вкуса/причин отзывов в контексте. Протокольную совместимость SDK 2 проверяет отдельный smoke-test в существующем окружении Hermes.