glbforge — MCP-сервер для Claude Code: что делает и как установить
Проверяет геометрию 3D-моделей, сжимает полисетки под веб-бюджеты и выдаёт отчёты метрик агенту прямо в процессе редактирования.
claude mcp add glbforge -e MESHY_API_KEY=<MESHY_API_KEY> -- npx -y @glbforge/mcpЧто делает glbforge
Сервер @glbforge/mcp даёт агенту 28 инструментов для работы с трёхмерными объектами. Команда inspect считывает топологию, проверяет геометрию на замкнутость и находит дыры за доли секунды. Через diff ассистент отслеживает регрессии между правками: смещение центра, перекос трансформаций или потерю треугольников с контролем углов обзора по метрике SSIM.
Для плоских логотипов инструмент обходится без нейросетей. Он строит векторный контур и выдаёт аккуратную геометрию на 1.5k полигонов вместо миллионов. Если подключён ключ MESHY_API_KEY, сервер отправляет сложные фотографии во внешний генератор и сразу оптимизирует результат.
Без переменной окружения MESHY_API_KEY генерация по тексту или фото завершится ошибкой. Локальная оптимизация и расчёт топологии при этом работают автономно.
Какие задачи решает
- проверить сетку модели на незамкнутые рёбра и дефекты
- сравнить две версии меша по метрике SSIM и числу треугольников
- выдавить двухмерный логотип в замкнутую 3D-модель
- оптимизировать полигоны под целевой веб-бюджет
Примеры запросов агенту
- Проверь файл
robot.glbчерез glbforge и покажи проблемы с топологией - Сравни
model_v1.glbиmodel_v2.glbи покажи, что сломалось в сетке - Преврати логотип
badge.pngв замкнутую модель формата GLB
Как установить glbforge
Командой платформы
claude mcp add glbforge -e MESHY_API_KEY=<MESHY_API_KEY> -- npx -y @glbforge/mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add glbforge --env MESHY_API_KEY=<MESHY_API_KEY> -- npx -y @glbforge/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"glbforge": {
"command": "npx",
"args": [
"-y",
"@glbforge/mcp"
],
"env": {
"MESHY_API_KEY": "<MESHY_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"glbforge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@glbforge/mcp"
],
"env": {
"MESHY_API_KEY": "<MESHY_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e MESHY_API_KEY=<MESHY_API_KEY> glbforge npx -y @glbforge/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о glbforge
Как установить glbforge в Claude Code?
Выполните команду claude mcp add glbforge -e MESHY_API_KEY=<MESHY_API_KEY> -- npx -y @glbforge/mcp. Для работы генерации укажите действующий ключ Meshy вместо плейсхолдера.
Зачем нужен glbforge?
Он даёт агентам возможность анализировать топологию мешей, находить структурные ошибки после правок и подгонять модели под веб-бюджеты.
Нужен ли GPU или нейросеть для превращения логотипа в 3D?
Нет, команда extrude обходится без нейросетей и опирается на алгоритмическую трассировку контура. Это создаёт лёгкую модель примерно на 1.5 тысячи полигонов без расхода API-кредитов.
