UVCS MCP — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер UVCS MCP подключает ИИ-агентов к Plastic SCM и Unity Version Control через утилиту cm. Помогает проверять диффы, создавать ветки и безопасно отправлять коммиты.
MIT ★ 18 обновлён 2026-10-26
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Что делает 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 с активной сессией и доступом к серверу репозитория.
Какие задачи решает
- проверить статус рабочего пространства Plastic SCM и список изменённых файлов
- зафиксировать изменения ассетов Unity строго вместе с парными файлами
.meta - создать ветку или метку в системе контроля версий без консольного доступа
- просмотреть детали слияния и заблокировать операцию при наличии конфликтов
Примеры запросов агенту
- Покажи статус воркспейса Unity Version Control и список незакоммиченных файлов
- Подготовь чекин изменённых скриптов и ассетов вместе с их мета-файлами
- Проверь готовность к слиянию ветки и убедись в отсутствии конфликтов
Как установить UVCS MCP
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы об UVCS MCP
Как установить UVCS MCP в Claude Code?
Выполните команду claude mcp add uvcs-mcp -e UVCS_WORKSPACE=<UVCS_WORKSPACE> -- npx -y @proanima/uvcs-mcp, подставив путь к вашему рабочему пространству.
Управляет ли UVCS MCP объектами внутри сцен Unity?
Нет, сервер работает исключительно с системой контроля версий через CLI cm. Он не меняет сцены, игровые объекты и параметры компонентов в самом редакторе.
Что требуется для запуска сервера?
Нужна среда Node.js 22 или новее, существующее рабочее пространство Plastic SCM, а также утилита cm версии 10.0.16.6656+, в которой выполнен вход в аккаунт.