three.ws Vision — MCP-сервер: что делает и как установить
Распознаёт текст на скриншотах, описывает сцены и проверяет трёхмерные рендеры через нейросети. Работает через stdio без личного API-ключа и оплаты.
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Что делает three.ws 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.
Какие задачи решает
- Считать текст со скриншота через OCR
- Составить текст для атрибута alt к иллюстрации
- Оценить трёхмерный рендер по текстовому описанию
- Определить объекты на фотографии по публичной ссылке
Примеры запросов агенту
- Прочитай надпись на логотипе по адресу
https://three.ws/logo.pngчерезanalyze_image. - Сделай краткое описание этой картинки в формате base64 для атрибута alt.
- Проверь доступность сервиса через
get_vision_statusперед отправкой файла.
Как установить three.ws Vision
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о three.ws Vision
Как установить three.ws Vision в Claude Code?
Выполните в терминале команду claude mcp add vision-mcp -- npx -y @three-ws/vision-mcp. Сервер запустится через stdio без предварительной настройки.
Что делает three.ws Vision?
Сервер даёт агенту возможность распознавать текст на изображениях, классифицировать сцены и генерировать текстовые описания. Обработка графики идёт через конвейер vision-моделей NVIDIA NIM.
Нужен ли API-ключ для распознавания картинок?
Личный ключ не требуется, запросы обрабатываются бесплатно в пределах лимита на IP-адрес. Ключ THREE_WS_API_KEY нужен только для перехода на пользовательский уровень лимитов.
