Unity API Documentation

Unity API Documentation — MCP-сервер сообщества (автор — Codeturion). Точная документация по API Unity (2022, 2023, 6) для ИИ-агентов. Ставится через pip. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
Codeturion
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
python

Уровень риска: medium

Только чтение локальной базы документации; сеть нужна для загрузки базы с GitHub.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"unity-api\": {\n      \"command\": \"uvx\",\n      \"args\": [\"unity-api-mcp\"],\n      \"env\": {\n        \"UNITY_PROJECT_PATH\": \"/path/to/your/unity-project\"\n      }\n    }\n  }\n}",
    "file": ".cursor/mcp.json",
    "lang": "json",
    "notes": "Дословно из README, вариант с путём к проекту; README называет mcp.json и Cursor",
    "verified": "docs"
}

Что умеет

unity-api-mcp — MCP-сервер, который даёт ИИ-агентам точную документацию по API Unity. Он не даёт модели выдумывать сигнатуры, путать пространства имён и использовать устаревшие методы. Поддерживаются Unity 6 (отдельная база на каждую минорную ветку), Unity 2023 и Unity 2022 LTS. Устанавливать Unity не нужно.

Инструмент Что делает Пример
search_unity_api Поиск API по ключевым словам «Tilemap SetTile», «async load scene»
get_method_signature Точные сигнатуры со всеми перегрузками UnityEngine.Physics.Raycast
get_namespace Нужная директива using SceneManager → using UnityEngine.SceneManagement;
get_class_reference Полная справка по классу InputAction → все методы, поля и свойства
get_deprecation_warnings Проверка, устарел ли API WWW → использовать UnityWebRequest

База покрывает все модули UnityEngine и UnityEditor, а также пакеты, разобранные из исходников C#: Input System, Addressables, uGUI (с TextMeshPro в Unity 6), AI Navigation и Netcode. В базе для Unity 6 около 42 500 записей и около 500 предупреждений об устаревании. Сторонние ассеты (DOTween, VContainer, Newtonsoft.Json) не покрываются.

Кому подойдёт

  • Разработчикам игр на Unity, которые пишут код с ИИ-агентом и устали от несуществующих методов.
  • Тем, кто переходит между версиями Unity: сервер подскажет, что устарело и чем заменить.
  • Командам с проектами на разных версиях: версия определяется по проекту автоматически.

Похожие серверы — в категории разработка и в подборке MCP для Unity.

Установка

Сервер запускается через uvx, отдельная установка не нужна. Можно поставить и через pip: pip install unity-api-mcp.

Версия Unity определяется в таком порядке: переменная UNITY_VERSION (например, "6000.3", "6", "2023", "2022"), затем UNITY_PROJECT_PATH — сервер читает ProjectSettings/ProjectVersion.txt вашего проекта, — иначе по умолчанию "6". При первом запуске сервер скачивает нужную базу (20–30 МБ) в ~/.unity-api-mcp/. При запуске он проверяет, не вышла ли свежая база: новые патчи Unity собираются автоматически каждый понедельник. Базу можно собрать и из своей установки Unity — для этого есть модуль unity_api_mcp.ingest.

Подключение к клиентам

Конфиг приведён дословно из README: он добавляется в .mcp.json, mcp.json или настройки MCP вашего инструмента. Укажите UNITY_VERSION под свой проект. Общий порядок — в инструкции как подключить MCP.

.mcp.json
{
  "mcpServers": {
    "unity-api": {
      "command": "uvx",
      "args": ["unity-api-mcp"],
      "env": {
        "UNITY_VERSION": "6000.3"
      }
    }
  }
}

Вариант с UNITY_PROJECT_PATH тоже взят из README: вместо версии указывается путь к проекту.

Проверка

Спросите агента: «Какая сигнатура у Physics.Raycast?» Он вызовет get_method_signature и покажет все перегрузки. Каждый запрос к локальной базе выполняется быстрее 15 мс.

Примеры задач

Какой using нужен для SceneManager и как асинхронно загрузить сцену?
Проверь, не устарели ли API, которые используются в этом скрипте, и предложи замену.

Риски

Сервер только читает локальную базу SQLite с документацией и ничего не меняет в проекте. Сетевой доступ нужен, чтобы скачать базу с GitHub и проверить обновления. Ключи и аккаунты не нужны.

Ограничения: сервер не знает о сторонних ассетах — по ним агенту нужно читать исходники проекта. Если установлена версия 2.1.0 или старше с mcp 2.x, может появиться ошибка ModuleNotFoundError — README советует перезапустить клиент или обновить пакет. Лицензия — MIT.

Частые вопросы

Нужно ли устанавливать Unity?

Нет. Сервер скачивает готовую базу для нужной версии. Unity нужна, только если вы хотите собрать базу сами.

Как сервер узнаёт версию Unity?

Из UNITY_VERSION, из файла ProjectSettings/ProjectVersion.txt по пути UNITY_PROJECT_PATH, иначе используется Unity 6.

Основы протокола — на странице что такое MCP-сервер.

Инструменты

  • search_unity_api
  • get_method_signature
  • get_namespace
  • get_class_reference
  • get_deprecation_warnings

Похожие MCP-серверы

MCP for Blender

MCP-сервер сообщества для Blender: создание сцен, материалов и объектов, Python-код и ресурсы Poly Haven.

Риск: high Лицензия: MIT ★ 34 950

MCP for Unity

MCP-сервер сообщества для редактора Unity: сцены, объекты, C#-скрипты, ассеты, тесты и сборка.

Риск: high Лицензия: MIT ★ 16 062

AI Game Developer (Unity-MCP)

MCP-сервер сообщества для Unity с генерацией навыков под проект, облачным входом и работой в собранной игре.

Риск: high Лицензия: Apache-2.0 ★ 4 663

MCP Unity

Плагин сообщества для Unity 6 с MCP-сервером на Node.js: объекты, сцены, префабы, тесты и логи консоли.

Риск: high Лицензия: MIT ★ 2 019

Источники