ugs-mcp — MCP-сервер для Claude Code: управление ЧПУ
Подключает ИИ-агента к станку ЧПУ через Universal GCode Sender: он может проверять G-код, читать состояние и запускать движения после вашего подтверждения.
claude mcp add --env UGS_HOST=<UGS_HOST> --env UGS_PORT=<UGS_PORT> --env MACROS_DIR=<MACROS_DIR> --env RAPID_SPEED_MM_MIN=<RAPID_SPEED_MM_MIN> --transport stdio ugs-mcp -- uvx ugs-mcpЧто делает ugs-mcp
Сервер связывает агента с Universal GCode Sender через REST API Pendant. Он показывает состояние станка, координаты и параметры шпинделя, проверяет G-код, оценивает время цикла и управляет заданиями, макросами и движением осей.
Перед каждым движением нужен отдельный токен подтверждения: агент показывает предварительный просмотр и токен, а станок движется только после того, как вы передадите токен обратно. Токен одноразовый и действует 2 минуты. Это важный барьер, но он не заменяет чтение SAFETY.md и знание расположения аварийной остановки.
Нужны Universal GCode Sender 2.x с активным плагином Pendant и Python 3.11+. По умолчанию Pendant доступен на localhost:8080; адрес и другие параметры можно задать переменными окружения. В README описаны тесты с GRBL-станком SainSmart Genmitsu 3018 Pro.
Какие задачи решает
- проверить G-код на риски до запуска
- узнать координаты и состояние станка
- переместить оси после подтверждения токеном
- запустить файл или макрос через UGS
Примеры запросов агенту
- Проверь этот G-код на риски и оцени время цикла.
- Покажи состояние станка и его текущие координаты.
- Подготовь перемещение оси X на 5 мм и покажи токен подтверждения.
Как установить ugs-mcp
Командой платформы
claude mcp add --env UGS_HOST=<UGS_HOST> --env UGS_PORT=<UGS_PORT> --env MACROS_DIR=<MACROS_DIR> --env RAPID_SPEED_MM_MIN=<RAPID_SPEED_MM_MIN> --transport stdio ugs-mcp -- uvx ugs-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from ugs-mcp <команда>
Командой платформы
codex mcp add ugs-mcp --env UGS_HOST=<UGS_HOST> --env UGS_PORT=<UGS_PORT> --env MACROS_DIR=<MACROS_DIR> --env RAPID_SPEED_MM_MIN=<RAPID_SPEED_MM_MIN> -- uvx ugs-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from ugs-mcp <команда>
Файл настроек
{
"mcpServers": {
"ugs-mcp": {
"command": "uvx",
"args": [
"ugs-mcp"
],
"env": {
"UGS_HOST": "<UGS_HOST>",
"UGS_PORT": "<UGS_PORT>",
"MACROS_DIR": "<MACROS_DIR>",
"RAPID_SPEED_MM_MIN": "<RAPID_SPEED_MM_MIN>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from ugs-mcp <команда>
Файл настроек
{
"servers": {
"ugs-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"ugs-mcp"
],
"env": {
"UGS_HOST": "<UGS_HOST>",
"UGS_PORT": "<UGS_PORT>",
"MACROS_DIR": "<MACROS_DIR>",
"RAPID_SPEED_MM_MIN": "<RAPID_SPEED_MM_MIN>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from ugs-mcp <команда>
Командой платформы
gemini mcp add -e UGS_HOST=<UGS_HOST> -e UGS_PORT=<UGS_PORT> -e MACROS_DIR=<MACROS_DIR> -e RAPID_SPEED_MM_MIN=<RAPID_SPEED_MM_MIN> ugs-mcp uvx ugs-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from ugs-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ugs-mcp
Как установить ugs-mcp в Claude Code?
Выполните claude mcp add ugs-mcp -- uvx ugs-mcp. Для подключения заранее настройте Universal GCode Sender 2.x и активный плагин Pendant.
Что делает ugs-mcp?
Он подключает ИИ-агента к CNC-станку через UGS Pendant: позволяет проверять G-код, получать состояние и управлять движением. Команды движения требуют токена, который пользователь передаёт после просмотра предварительного результата.
Что нужно для работы ugs-mcp?
Нужны Universal GCode Sender 2.x, активный плагин Pendant и Python 3.11+. В описанной конфигурации Pendant работает на localhost:8080.
