3D Visualizer — MCP-сервер для Claude Code: облака точек и меши
Показывает облака точек, меши и данные глубины прямо в диалоге с агентом или в Python. Пригодится, когда нужно посмотреть скан, а не гадать по числам.
claude mcp add python -- uvx 3d-visualizerЧто делает 3D Visualizer
Сервер принимает файлы PLY, STL и калиброванную глубину, отдаёт их в интерактивный просмотрщик и умеет сохранять снимок кадра. Работает в двух режимах: как MCP-сервер для агента и как Python-библиотека с импортом from viz3d import show. В Python можно передавать списки, массивы NumPy и тензоры PyTorch формы (N, 3) — тензоры на GPU и с autograd тоже принимаются, вручную вызывать .detach() или .numpy() не нужно.
Нужен Python 3.10+. Для безоконного режима ставят extra headless и один раз доустанавливают Chromium через playwright install chromium, после чего проверяют командой 3d-visualizer doctor --check-headless. Без Chromium offscreen-рендер не поднимется.
По умолчанию --tools core открывает восемь повседневных инструментов, а --tools full добавляет конвертацию глубины, выделения, анимацию, выравнивание и экспорт. Рендер выбирается флагом --renderer: auto берёт хост MCP Apps, иначе уходит в offscreen Chromium, inline требует виджет или явный браузер, headless рассчитан на работу без присмотра. Массивы передаются построчно через временный бинарный PLY, так что для очень больших наборов это не zero-copy.
Какие задачи решает
- посмотреть облако точек из скана, не открывая отдельный просмотрщик
- сравнить два меша и сохранить снимок кадра
- показать тензор PyTorch прямо из скрипта обучения
- отрендерить превью без окна браузера на сервере
- выгрузить данные глубины в другой формат
Примеры запросов агенту
- Открой
scan.plyи покажи, что внутри — сколько точек и какой bounding box - Сравни
scan.plyиmesh.stlи сохрани превью вpreview.png - Сделай безоконный рендер
scan.plyи верни снимок
Как установить 3D Visualizer
Командой платформы
claude mcp add python -- uvx 3d-visualizeruvx запускает команду с именем пакета; если в README она другая — uvx --from 3d-visualizer <команда>
Командой платформы
codex mcp add python -- uvx 3d-visualizeruvx запускает команду с именем пакета; если в README она другая — uvx --from 3d-visualizer <команда>
Файл настроек
{
"mcpServers": {
"python": {
"command": "uvx",
"args": [
"3d-visualizer"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from 3d-visualizer <команда>
Файл настроек
{
"servers": {
"python": {
"type": "stdio",
"command": "uvx",
"args": [
"3d-visualizer"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from 3d-visualizer <команда>
Командой платформы
gemini mcp add python uvx 3d-visualizeruvx запускает команду с именем пакета; если в README она другая — uvx --from 3d-visualizer <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о 3D Visualizer
Как установить 3D Visualizer в Claude Code?
Выполните claude mcp add python -- uvx 3d-visualizer. Для безоконного режима сначала поставьте пакет с extra headless и доустановите Chromium.
Что делает 3D Visualizer?
Открывает облака точек, меши и калиброванную глубину в интерактивном просмотрщике, умеет сравнивать их и сохранять снимок. Тот же движок доступен из Python через from viz3d import show.
Что нужно для безоконного рендера?
Extra headless и установленный Chromium: uvx --from "3d-visualizer[headless]==0.5.0.dev0" playwright install chromium. Проверить готовность можно командой 3d-visualizer doctor --check-headless.
