# Unity MCP Server

Открывает ИИ-ассистентам доступ к файлам, сценам и настройкам Unity без запуска редактора. Пригодится для разбора структуры проекта через терминал или IDE.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Автор: rachitkumarrastogi
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/rachitkumarrastogi/unity-mcp-server
- Обновлён: 2026-08-04
- HTML: https://affpapa.org/nevibecode/mcp/unity-mcp-server

## Что делает

Сервер работает напрямую с диском и парсит файлы ассетов, манифесты пакетов и параметры движка через стандартный ввод-вывод stdio. Благодаря этому Claude Code, Cursor или другие клиенты видят порядок сцен в сборке, теги слоёв, настройки физики и список пакетов. Запускать сам Unity Editor не требуется.

Внутри заложены десятки инструментов для анализа структуры кода, поиска зависимостей между сборками asmdef и проверки матрицы коллизий. Инструмент умеет строить граф пакетов и читать глобальные настройки проекта.

Для работы серверу обязательно нужна переменная окружения `UNITY_PROJECT_PATH` с путём к корню проекта, иначе обращаться к файлам не получится.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `UNITY_PROJECT_PATH` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.
- Работает с: Unity

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add unity-mcp-server -e UNITY_PROJECT_PATH=<UNITY_PROJECT_PATH> -- npx -y unity-mcp-server
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add unity-mcp-server --env UNITY_PROJECT_PATH=<UNITY_PROJECT_PATH> -- npx -y unity-mcp-server
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "unity-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "unity-mcp-server"
            ],
            "env": {
                "UNITY_PROJECT_PATH": "<UNITY_PROJECT_PATH>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "unity-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "unity-mcp-server"
            ],
            "env": {
                "UNITY_PROJECT_PATH": "<UNITY_PROJECT_PATH>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e UNITY_PROJECT_PATH=<UNITY_PROJECT_PATH> unity-mcp-server npx -y unity-mcp-server
```
Вместо <…> подставьте свои значения

## Когда брать
- проверить список сцен и порядок их сборки
- найти зависимости между сборками asmdef
- выяснить параметры слоёв и матрицы столкновений
- просмотреть установленные пакеты движка

## Примеры запросов агенту
- Какие сцены включены в текущую сборку Unity?
- Покажи матрицу столкновений для физических слоёв
- Какие сборки ссылаются на `MyGame.Core`?

## Похожие
- [Pascal 3D Editor](https://affpapa.org/nevibecode/mcp/pascal-3d-editor.md) — MCP-сервер · ★ 25137
- [Unity-MCP](https://affpapa.org/nevibecode/mcp/unity-mcp.md) — MCP-сервер · ★ 4534
- [mcp](https://affpapa.org/nevibecode/mcp/sceneview-mcp.md) — MCP-сервер · ★ 1349
- [Gearboy MCP Server](https://affpapa.org/nevibecode/mcp/gearboy-mcp-server.md) — MCP-сервер · ★ 1218
- [ChiR24-unreal_mcp_server](https://affpapa.org/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP-сервер · ★ 982
- [Nova3D](https://affpapa.org/nevibecode/mcp/nova3d.md) — MCP-сервер · ★ 732

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
