# UVCS MCP

MCP-сервер UVCS MCP подключает ИИ-агентов к Plastic SCM и Unity Version Control через утилиту cm. Помогает проверять диффы, создавать ветки и безопасно отправлять коммиты.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 18 у репозитория
- Автор: ProAnima
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ProAnima/unity-version-control-mcp
- Обновлён: 2026-10-26
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/uvcs-mcp

## Что делает

Сервер связывает модели в редакторах кода с локальным интерфейсом командной строки `cm`. Он работает с Plastic SCM и Unity Version Control версий 10.0.16.6656 и новее, включая линейку 11.x. Инструмент даёт возможность исследовать историю репозитория, смотреть ожидающие правки, создавать ветки, расставлять метки и запускать слияния без прямого доступа агента к оболочке операционной системы.

Это не инструмент для управления Unity Editor: он не взаимодействует со сценами, пакетами, окнами редактора или объектами в Play Mode. Все операции ограничены контролем версий. Для защиты кодовой базы сервер по умолчанию работает в режиме `readonly`. Запись требует двухэтапного подтверждения через связку вызовов prepare и confirm, а при коммитах ассетов Unity проверяется обязательное наличие парных файлов `.meta`.

Для работы критично наличие Node.js 22 или новее, а также настроенного клиента `cm` с активной сессией и доступом к серверу репозитория.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add --env UVCS_WORKSPACE=<UVCS_WORKSPACE> --env UVCS_MCP_MODE=<UVCS_MCP_MODE> --env UVCS_ALLOWED_WORKSPACES=<UVCS_ALLOWED_WORKSPACES> --env UVCS_ALLOWED_REPOS=<UVCS_ALLOWED_REPOS> --env UVCS_CM_PATH=<UVCS_CM_PATH> --transport stdio uvcs-mcp -- npx -y @proanima/uvcs-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add uvcs-mcp --env UVCS_WORKSPACE=<UVCS_WORKSPACE> --env UVCS_MCP_MODE=<UVCS_MCP_MODE> --env UVCS_ALLOWED_WORKSPACES=<UVCS_ALLOWED_WORKSPACES> --env UVCS_ALLOWED_REPOS=<UVCS_ALLOWED_REPOS> --env UVCS_CM_PATH=<UVCS_CM_PATH> -- npx -y @proanima/uvcs-mcp
```
Вместо <…> подставьте свои значения

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e UVCS_WORKSPACE=<UVCS_WORKSPACE> -e UVCS_MCP_MODE=<UVCS_MCP_MODE> -e UVCS_ALLOWED_WORKSPACES=<UVCS_ALLOWED_WORKSPACES> -e UVCS_ALLOWED_REPOS=<UVCS_ALLOWED_REPOS> -e UVCS_CM_PATH=<UVCS_CM_PATH> uvcs-mcp npx -y @proanima/uvcs-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- проверить статус рабочего пространства Plastic SCM и список изменённых файлов
- зафиксировать изменения ассетов Unity строго вместе с парными файлами `.meta`
- создать ветку или метку в системе контроля версий без консольного доступа
- просмотреть детали слияния и заблокировать операцию при наличии конфликтов

## Примеры запросов агенту
- Покажи статус воркспейса Unity Version Control и список незакоммиченных файлов
- Подготовь чекин изменённых скриптов и ассетов вместе с их мета-файлами
- Проверь готовность к слиянию ветки и убедись в отсутствии конфликтов

## Похожие
- [unity-build-pipeline](https://affpapa.org/nevibecode/skills/unity-build-pipeline.md) — скилл · 11100 установок
- [unity-package-management](https://affpapa.org/nevibecode/skills/unity-package-management.md) — скилл · 9000 установок
- [optimize-web](https://affpapa.org/nevibecode/skills/optimize-web.md) — скилл · 6600 установок
- [test-setup](https://affpapa.org/nevibecode/skills/test-setup.md) — скилл · 633 установки
- [scenario-unity-pipeline-automation](https://affpapa.org/nevibecode/skills/scenario-unity-pipeline-automation.md) — скилл · 567 установок
- [game-ci-cd-pipeline](https://affpapa.org/nevibecode/skills/game-ci-cd-pipeline.md) — скилл · 297 установок

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