Unity MCP Server

Unity MCP Server

rachitkumarrastogi
2 звёзд1 форков
Unity MCP Server — инструмент для интеграции Unity-проектов с AI-ассистентами через протокол MCP. Сервер читает файлы проекта напрямую с диска и передаёт ассистенту структурированную информацию: настройки проекта, списки сцен, скрипты, префабы и другие ассеты. Для работы не нужен запущенный Unity Editor — достаточно указать путь к папке проекта. Сервер использует стандартный MCP-протокол через stdio, поэтому совместим с любым клиентом, поддерживающим MCP: Cursor, Claude Desktop, VS Code (с плагином), Windsurf, Continue и другие. Один сервер подходит для нескольких проектов — нужно лишь менять переменную окружения UNITY_PROJECT_PATH.
DevelopmentProductivityUnityGaming
Открыть на GitHub

Установка

npx -y unity-mcp-server

Характеристики

Общее

  • СтатусСообщество
  • Разработчикrachitkumarrastogi

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Просмотр общей информации о проекте: версия Unity, список платформ сборки, настройки проигрывателя.
  • Получение списка сцен с параметрами — включены ли в сборку и порядковый номер.
  • Поиск и чтение C#-скриптов: имена файлов, содержимое, наследование от MonoBehaviour или ScriptableObject.
  • Просмотр префабов, материалов, текстур, шейдеров и их свойств.
  • Поиск ассетов по имени, типу или пути в папках Assets и Packages.
  • Чтение содержимого любых файлов проекта: .unity, .asset, .meta, JSON, YAML.
  • Ведение документации агента: сохранение заметок, привязанных к проекту, и их чтение.
  • Обзор структуры каталогов проекта — дерево папок и файлов.

Как подключить

Установка сервера не требуется — он запускается через npx. Добавьте его в настройки вашего MCP-клиента.

  1. Проверьте работу сервера командой:
    npx -y unity-mcp-server
  2. В конфигурационном файле клиента (например, claude_desktop_config.json) пропишите новый сервер:
{ "mcpServers": { "unity-mcp-server": { "command": "npx", "args": ["-y", "unity-mcp-server"], "env": { "UNITY_PROJECT_PATH": "/путь/к/вашему/unity-проекту" } } } }
  1. Перезапустите клиент. Сервер подключится автоматически.

Для других клиентов (Cursor, VS Code) используйте ту же команду и переменную окружения — формат конфигурации аналогичный.

Примеры запросов

  • «Покажи список всех сцен и отметь, какие включены в билд.»
  • «Найди все скрипты в папке Scripts, которые наследуются от MonoBehaviour.»
  • «Выведи структуру папки Assets — первые три уровня вложенности.»
  • «Какая версия Unity стоит в проекте? Перечисли платформы из настроек сборки.»

Технические детали

  • Язык реализации: TypeScript
  • Транспорт: stdio (MCP)
  • Лицензия: не указана (открытый исходный код)
  • Совместимые клиенты: Cursor, Claude Desktop, VS Code (с MCP-расширением), Windsurf, Continue, Cline, Zed, Roo Code, LibreChat и любые другие MCP-клиенты
  • Требования: Node.js

Поделиться