Hera Agent Unity — MCP-сервер для Claude Code
Локальный MCP-сервер, который подключает агента к запущенному Unity Editor: тот видит компиляцию, Console и сцену, а потом сам правит и проверяет.
claude mcp add --env HERA_MCP_ENABLED=<HERA_MCP_ENABLED> --transport stdio hera-agent-unity -- npx -y hera-agent-unityЧто делает Hera Agent Unity
Сервер соединяет агента с живым Unity Editor. Агент больше не угадывает по исходникам: он спрашивает состояние компиляции, ошибки в Console, открытую сцену, объекты и сериализованные поля компонентов. Дальше меняет сцену, добавляет и удаляет объекты, правит ассеты под Assets/.
Запускается через npx -y hera-agent-unity, свой рантайм держать не надо. Если нужный Editor закрыт, его поднимает editor launch с флагом --project: версия берётся из ProjectSettings/ProjectVersion.txt, установка Unity Hub — из UNITY_HUB_EDITOR либо из платформенного пути (%ProgramFiles%\Unity\Hub\Editor на Windows), нестандартный Hub задаётся через --hub-root.
Планка версии — Unity 6000.6 или новее, ничего более старого не подойдёт. Кроме правок агент гоняет EditMode- и PlayMode-тесты, входит в Play Mode, снимает Scene и Game view, синтезирует ввод через Input System. Разрушительные операции проходят предполётную проверку и требуют совпадающего токена подтверждения — это стоит держать включённым на живом проекте.
Какие задачи решает
- узнать, что правка не скомпилировалась, до запуска игры
- вытащить ошибки из Console, не переключаясь на Editor
- собрать uGUI-сцену и увидеть, как она выглядит на самом деле
- прогнать PlayMode-тесты и починить упавшие
- поднять нужный Editor по версии из
ProjectSettings/ProjectVersion.txt
Примеры запросов агенту
- Проверь, что Editor скомпилировал проект без ошибок, и покажи, что лежит в Console.
- Собери сцену
Main: добавь Canvas с кнопкой, подпиши её, потом сними Game view и сравни с макетом. - Запусти PlayMode-тесты, найди упавшие и правь код до зелёного прогона.
Как установить Hera Agent Unity
Командой платформы
claude mcp add --env HERA_MCP_ENABLED=<HERA_MCP_ENABLED> --transport stdio hera-agent-unity -- npx -y hera-agent-unityВместо <…> подставьте свои значения
Командой платформы
codex mcp add hera-agent-unity --env HERA_MCP_ENABLED=<HERA_MCP_ENABLED> -- npx -y hera-agent-unityВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"hera-agent-unity": {
"command": "npx",
"args": [
"-y",
"hera-agent-unity"
],
"env": {
"HERA_MCP_ENABLED": "<HERA_MCP_ENABLED>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"hera-agent-unity": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hera-agent-unity"
],
"env": {
"HERA_MCP_ENABLED": "<HERA_MCP_ENABLED>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e HERA_MCP_ENABLED=<HERA_MCP_ENABLED> hera-agent-unity npx -y hera-agent-unityВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Hera Agent Unity
Как установить Hera Agent Unity в Claude Code?
Одной командой: claude mcp add hera-agent-unity -- npx -y hera-agent-unity. После неё сервер появляется в списке MCP и агент может обращаться к Editor.
Что делает Hera Agent Unity?
Даёт агенту доступ к живому Unity Editor: компиляция, Console, сцена, компоненты, тесты, Play Mode и снимки вида. Всё это возвращается агенту как факты проекта.
Какая версия Unity нужна для работы?
Unity 6000.6 или новее. Editor должен быть запущен; если его нет, editor launch --project стартует проект на версии из ProjectSettings/ProjectVersion.txt.
