# 3D Visualizer

Показывает облака точек, меши и данные глубины прямо в диалоге с агентом или в Python. Пригодится, когда нужно посмотреть скан, а не гадать по числам.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 22
- Автор: kleinicke
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/kleinicke/ply-visualizer/tree/HEAD/packages/python
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/mcp/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.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

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

**Командой платформы**
```bash
claude mcp add python -- uvx 3d-visualizer
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from 3d-visualizer <команда>

### Codex

**Командой платформы**
```bash
codex mcp add python -- uvx 3d-visualizer
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from 3d-visualizer <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "python": {
            "command": "uvx",
            "args": [
                "3d-visualizer"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from 3d-visualizer <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "python": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "3d-visualizer"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from 3d-visualizer <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add python uvx 3d-visualizer
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from 3d-visualizer <команда>

## Когда брать
- посмотреть облако точек из скана, не открывая отдельный просмотрщик
- сравнить два меша и сохранить снимок кадра
- показать тензор PyTorch прямо из скрипта обучения
- отрендерить превью без окна браузера на сервере
- выгрузить данные глубины в другой формат

## Примеры запросов агенту
- Открой `scan.ply` и покажи, что внутри — сколько точек и какой bounding box
- Сравни `scan.ply` и `mesh.stl` и сохрани превью в `preview.png`
- Сделай безоконный рендер `scan.ply` и верни снимок

## Похожие
- [Pascal 3D Editor](https://affpapa.org/nevibecode/mcp/pascal-3d-editor.md) — MCP-сервер · ★ 25085
- [Unity-MCP](https://affpapa.org/nevibecode/mcp/unity-mcp.md) — MCP-сервер · ★ 4523
- [mcp](https://affpapa.org/nevibecode/mcp/sceneview-mcp.md) — MCP-сервер · ★ 1348
- [Gearboy MCP Server](https://affpapa.org/nevibecode/mcp/gearboy-mcp-server.md) — MCP-сервер · ★ 1219
- [ChiR24-unreal_mcp_server](https://affpapa.org/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP-сервер · ★ 975
- [Nova3D](https://affpapa.org/nevibecode/mcp/nova3d.md) — MCP-сервер · ★ 733

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