unity-api-mcp
MCP-сервер с точной документацией Unity API для Claude Code и Cursor: сигнатуры, пространства имен и устаревшие методы
- 66 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Первый запуск скачивает базу данных с GitHub и пишет ее в домашнюю папку
- Сервер только читает документацию и не обращается к файлам проекта, кроме версии
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/unity-api-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Первый запуск скачивает базу данных с GitHub и пишет ее в домашнюю папку
- Сервер только читает документацию и не обращается к файлам проекта, кроме версии
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер отвечает агенту на вопросы об API Unity из локальной базы SQLite, чтобы код не опирался на выдуманные сигнатуры и устаревшие вызовы. Базы собраны для Unity 6 (отдельная на каждую ветку вроде `6000.3`), Unity 2023 и Unity 2022 LTS. Установка Unity для работы не нужна. У сервера пять инструментов: `search_unity_api` ищет интерфейсы по ключевым словам, `get_method_signature` возвращает точные сигнатуры со всеми перегрузками, `get_namespace` подсказывает нужную директиву `using`, `get_class_reference` выдает карточку класса со всеми методами, полями и свойствами, `get_deprecation_warnings` показывает, что метод устарел и чем его заменить. Нужную версию сервер определяет по переменной `UNITY_VERSION` или читает `ProjectSettings/ProjectVersion.txt` по пути из `UNITY_PROJECT_PATH`. При первом запуске он скачивает базу (около 20-30 МБ) в `~/.unity-api-mcp/` и дальше сверяет ее свежесть с релизом. Покрыты модули UnityEngine и UnityEditor, а также Input System, Addressables, uGUI, AI Navigation и Netcode.
Для кого. Разработчикам игр на Unity, чьи агенты путают перегрузки, пространства имен и устаревшие вызовы.
Подходит, если
- Агент пишет код под Unity 6, и надо сверить сигнатуры вроде `SceneManager.LoadSceneAsync`
- Непонятно, какую директиву `using` добавить для класса из UnityEngine
- Нужно узнать, устарел ли вызов `WWW`, и чем его заменить
- Проект ведется на Unity 2022 LTS или 2023, и ответы должны соответствовать этой ветке
Не подходит, если
- Вопрос про сторонние ассеты вроде DOTween, VContainer или Newtonsoft.Json: их в базе нет
- Нужно управлять самим редактором Unity: сервер только отвечает по документации
- Работа идет в Unreal Engine или Godot: база содержит только Unity
Пример запроса к агенту
Покажи все перегрузки `Physics.Raycast` для Unity 6 и подскажи, какую `using` добавить для `InputAction`MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
UNITY_VERSION- Версия Unity для базы: 2022, 2023 или 6, по умолчанию определяется автоматически или 6
UNITY_PROJECT_PATH- Путь к проекту Unity для чтения версии из ProjectSettings/ProjectVersion.txt
Ограничения
База покрывает модули UnityEngine и UnityEditor и пакеты Input System, Addressables, uGUI, AI Navigation и Netcode, а сторонние ассеты остаются на исходниках проекта. Поддерживаются Unity 6, 2023 и 2022 LTS, остальные версии не обслуживаются. При первом запуске сервер скачивает базу с GitHub, поэтому нужен доступ в сеть, затем она хранится в `~/.unity-api-mcp/`. Агент увидит инструменты, но не обязательно поймет, когда ими пользоваться: автор советует добавить сниппет в `CLAUDE.md` или файл инструкций. Запуск идет через `uvx`, нужны `uv` и Python.
Как отключить. Уберите запись `unity-api` из MCP-конфигурации клиента и при желании удалите папку `~/.unity-api-mcp/` с базой.
Частые вопросы
Как подключить unity-api-mcp к Claude Code или Cursor?
Добавьте в `.mcp.json` или настройки MCP сервер с `command` `uvx`, `args` `["unity-api-mcp"]` и переменной `UNITY_VERSION` под версию проекта. Ключ API не нужен.
Какие версии Unity поддерживаются?
Unity 6 (отдельная база на каждую ветку, например `6000.3`), Unity 2023 и Unity 2022 LTS. Новые релизы Unity определяются и собираются автоматически раз в неделю.
Нужна ли установленная Unity?
Нет. Сервер работает с собственной базой, которую скачивает при первом запуске, и версию берет из `UNITY_VERSION` или из `ProjectSettings/ProjectVersion.txt`.
Зачем сервер, если агент умеет искать по коду?
Точные перегрузки, пространства имен и устаревшие вызовы лежат вне файлов проекта. В тесте автора на 25 вопросах агент с этим сервером ответил верно на 24 вопроса без единого выдуманного API. У агентов без него нашлось по одной несуществующей перегрузке.
Знает ли сервер сторонние плагины вроде DOTween?
Нет, в базе только модули Unity и перечисленные пакеты. Для DOTween, VContainer и Newtonsoft.Json агент опирается на исходники проекта.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыunreal-api-mcp — справочник API Unreal Engine
unreal-api-mcp
Справочник C++ API Unreal Engine по MCP: точные сигнатуры, пути include и устаревшие функции без чтения исходников
Пакет Unity: редактор сам отдает MCP по HTTP, а агент и командная строка управляют сценами, ассетами и сборкой
MCP-сервер, который связывает AI-агента с редактором Unity: управление сценой, объектами, пакетами и ресурсами проекта
Управление редактором Unity из агента через MCP: сцены и объекты, C#-скрипты, ассеты, тесты, профилирование и сборка
MCP-сервер внутри редактора Unity: агент создает сцены и скрипты, запускает play mode и проверяет игру скриншотами
MCP-сервер для Unity: управление сценой, объектами, компонентами, сборками и профилировкой из агента
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| unity-api-mcp (эта карточка) | нет | не нужна | 66 | |
| MCP Unity | нет | не нужна | 2 018 | сервер управления редактором Unity, а этот отвечает по документации API |
| Unity Skills | нет | 1 244 | набор скиллов с практиками Unity, а тут справочная база сигнатур для проверки кода |
Коротко о README
В README есть быстрый старт, описание выбора версии и загрузки базы, таблица инструментов, список покрытия и результаты теста на 25 вопросах. В конце лежит сниппет для файла инструкций агента.