[!Предупреждение] Этот репозиторий обесценен. Развитие переместилось в akiojin/unity-cli. Этот репозиторий больше не будет получать обновления. Пожалуйста, перейдите к проекту-преемнику.

Английский |

Обзор

Unity MCP Server позволяет клиентам на базе LLM автоматизировать редактор Unity. Он фокусируется на надежных, скриптовых рабочих процессах с простым интерфейсом и настройкой с нулевой или низкой конфигурацией.

Что можно сделать

** Автоматизация редактирования**: Создание/изменение сцен, GameObjects, компонентов, префабов, материалов ** Автоматизация интерфейса**: Найти и взаимодействовать с UI, проверить состояние UI ** Вводное моделирование**: клавиатура/мышь/геймпад/тач для тестирования в режиме воспроизведения (только система ввода)

• ** Визуальный захват**: Детерминированные скриншоты из Game/Scene/Explorer/Window Views ** Осведомленность о кодовой базе**: Безопасное структурированное редактирование и точный символ/поиск на основе пакетного C# LSP (не требуется файл [T0]) Проектный контроль: Read/update project/editor settings; read logs, monitor compilation ** Адресное управление**: Регистрировать/организовывать активы, управлять группами, создавать автоматизацию

##Спектакль

Инструменты индекса кода превосходят стандартные файловые операции:

| Операция | Инструмент индекса кода | Стандартный инструмент | Преимущества

Unity MCP Server

[!WARNING] This repository is deprecated. Development has moved to akiojin/unity-cli. This repository will no longer receive updates. Please migrate to the successor project.

English | 日本語

Overview

Unity MCP Server lets LLM-based clients automate the Unity Editor. It focuses on reliable, scriptable workflows with a simple interface and zero or low-configuration setup.

What It Can Do

• Editor automation: Create/modify scenes, GameObjects, components, prefabs, materials
• UI automation: Locate and interact with UI, validate UI state
• Input simulation: Keyboard/mouse/gamepad/touch for playmode testing (Input System only)
• Visual capture: Deterministic screenshots from Game/Scene/Explorer/Window views
• Code base awareness: Safe structured edits and accurate symbol/search powered by bundled C# LSP (no .sln file required)
• Project control: Read/update project/editor settings; read logs, monitor compilation
• Addressables management: Register/organize assets, manage groups, build automation

Performance

Code index tools outperform standard file operations:

Key benefits:

• 128,040 files indexed with 100% coverage
• Non-blocking background index builds (Worker Threads)
• LLM-optimized output with pagination and size limits

For detailed benchmarks, see docs/benchmark-results-2025-12-13.md

Requirements

• Unity 2020.3 LTS or newer
• Node.js 18.x / 20.x / 22.x / 24.x LTS (25+ not supported)
• Claude Desktop or another MCP-compatible client

Installation

Unity Package

Package Manager → Add from git URL:

https://github.com/akiojin/unity-mcp-server.git?path=UnityMCPServer/Packages/unity-mcp-server

Or via OpenUPM:

openupm add com.akiojin.unity-mcp-server

MCP Client Configuration

Configure your MCP client (Claude Desktop example):

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "unity-mcp-server": {
      "command": "npx",
      "args": ["@akiojin/unity-mcp-server@latest"]
    }
  }
}

HTTP Mode (for HTTP-only networks)

npx @akiojin/unity-mcp-server --http 6401 --no-telemetry
curl http://localhost:6401/healthz

Quick Start

1. Install the Unity package (Git URL or OpenUPM)
2. Configure your MCP client with the JSON above