# three.ws Vision

Распознаёт текст на скриншотах, описывает сцены и проверяет трёхмерные рендеры через нейросети. Работает через stdio без личного API-ключа и оплаты.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 249
- Автор: nirholas
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/nirholas/three.ws/tree/HEAD/packages/vision-mcp
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/threews-vision

## Что делает

Сервер добавляет три инструмента для анализа графики: `analyze_image`, `describe_image` и `get_vision_status`. Первый отвечает на текстовые запросы по картинке, читает надписи и находит объекты. Второй составляет краткие или подробные текстовые описания для атрибутов alt. Третий сообщает статус конвейера и поддерживаемые форматы.

Запросы сначала уходят в бесплатные модели NVIDIA NIM vision, а платный резерв на стороне сервиса подключается автоматически. Картинку можно передавать публичной ссылкой по протоколу HTTPS либо в виде строки base64. Поддерживаются форматы JPEG, PNG, WebP или GIF размером до 12 МБ.

Локальные адреса и приватные хосты в `imageUrl` сервер отклоняет сразу, потому что скачивает файл самостоятельно. Для запуска нужен Node.js версии 20 или выше. Лимиты запросов привязаны к IP-адресу, но при необходимости поднимаются переменной `THREE_WS_API_KEY`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `THREE_WS_BASE`, `THREE_WS_TIMEOUT_MS`, `THREE_WS_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --env THREE_WS_API_KEY=<THREE_WS_API_KEY> --transport stdio vision-mcp -- npx -y @three-ws/vision-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add vision-mcp --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --env THREE_WS_API_KEY=<THREE_WS_API_KEY> -- npx -y @three-ws/vision-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vision-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@three-ws/vision-mcp"
            ],
            "env": {
                "THREE_WS_BASE": "<THREE_WS_BASE>",
                "THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>",
                "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "vision-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@three-ws/vision-mcp"
            ],
            "env": {
                "THREE_WS_BASE": "<THREE_WS_BASE>",
                "THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>",
                "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e THREE_WS_BASE=<THREE_WS_BASE> -e THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> -e THREE_WS_API_KEY=<THREE_WS_API_KEY> vision-mcp npx -y @three-ws/vision-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- Считать текст со скриншота через OCR
- Составить текст для атрибута alt к иллюстрации
- Оценить трёхмерный рендер по текстовому описанию
- Определить объекты на фотографии по публичной ссылке

## Примеры запросов агенту
- Прочитай надпись на логотипе по адресу `https://three.ws/logo.png` через `analyze_image`.
- Сделай краткое описание этой картинки в формате base64 для атрибута alt.
- Проверь доступность сервиса через `get_vision_status` перед отправкой файла.

## Похожие
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16717
- [labelhead-artist-momentum](https://affpapa.org/nevibecode/mcp/labelhead-artist-momentum.md) — MCP-сервер · ★ 107423
- [Agent Skills Search Server](https://affpapa.org/nevibecode/mcp/agent-skills-search-server.md) — MCP-сервер · ★ 26559
- [Skyvern](https://affpapa.org/nevibecode/mcp/skyvern.md) — MCP-сервер · ★ 23263
- [Nhost](https://affpapa.org/nevibecode/mcp/nhost.md) — MCP-сервер · ★ 9366
- [PraisonAI](https://affpapa.org/nevibecode/mcp/praisonai.md) — MCP-сервер · ★ 9289

Из того же набора: [nirholas/three.ws](https://affpapa.org/nevibecode/by/nirholas/three.ws.md) — 43 карточки

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