SketchUp MCP: три сервера и подключение к Claude Code, Codex и Cursor

zinin/sketchup-mcp2· Проверено 12.11.2026· 60на GitHub

Связывает агента с открытой моделью SketchUp через расширение-мост: создать и подвинуть компоненты, покрасить, выгрузить сцену и выполнить любой код на Ruby прямо в программе.

3 реализации:

Форк SketchupMCP с новым протоколом: размеры в миллиметрах, булевы операции, фаски, столярные соединения, снимок вьюпорта и откат каждого вызова одним Undo; несколько клиентов сразу.

Как подключить

Что сделать до подключения

uv: команда uvx сама скачает пакет sketchup-mcp2 из PyPI

Скачать .rbz со страницы Releases, в SketchUp открыть Window → Extension Manager → Install Extension и перезапустить программу

Запустить мост: Plugins → MCP Server → Start Server, по умолчанию 127.0.0.1:9876

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env SKETCHUP_MCP_HOST=127.0.0.1 --env SKETCHUP_MCP_PORT=9876 --env SKETCHUP_MCP_TIMEOUT=60 --transport stdio sketchup \
  -- uvx sketchup-mcp2

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.sketchup]
command = "uvx"
args = ["sketchup-mcp2"]

[mcp_servers.sketchup.env]
SKETCHUP_MCP_HOST = "127.0.0.1"
SKETCHUP_MCP_PORT = "9876"
SKETCHUP_MCP_TIMEOUT = "60"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "sketchup": {
      "command": "uvx",
      "args": ["sketchup-mcp2"],
      "env": {
        "SKETCHUP_MCP_HOST": "127.0.0.1",
        "SKETCHUP_MCP_PORT": "9876",
        "SKETCHUP_MCP_TIMEOUT": "60"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "sketchup": {
      "type": "stdio",
      "command": "uvx",
      "args": ["sketchup-mcp2"],
      "env": {
        "SKETCHUP_MCP_HOST": "127.0.0.1",
        "SKETCHUP_MCP_PORT": "9876",
        "SKETCHUP_MCP_TIMEOUT": "60"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "sketchup": {
      "command": "uvx",
      "args": ["sketchup-mcp2"],
      "env": {
        "SKETCHUP_MCP_HOST": "127.0.0.1",
        "SKETCHUP_MCP_PORT": "9876",
        "SKETCHUP_MCP_TIMEOUT": "60"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "sketchup": {
      "command": "uvx",
      "args": ["sketchup-mcp2"],
      "env": {
        "SKETCHUP_MCP_HOST": "127.0.0.1",
        "SKETCHUP_MCP_PORT": "9876",
        "SKETCHUP_MCP_TIMEOUT": "60"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "sketchup": {
        "type": "local",
        "command": ["uvx", "sketchup-mcp2"],
        "environment": {
          "SKETCHUP_MCP_HOST": "127.0.0.1",
          "SKETCHUP_MCP_PORT": "9876",
          "SKETCHUP_MCP_TIMEOUT": "60"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "sketchup": {
      "command": "uvx",
      "args": ["sketchup-mcp2"],
      "env": {
        "SKETCHUP_MCP_HOST": "127.0.0.1",
        "SKETCHUP_MCP_PORT": "9876",
        "SKETCHUP_MCP_TIMEOUT": "60"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "sketchup": {
      "command": "uvx",
      "args": ["sketchup-mcp2"],
      "env": {
        "SKETCHUP_MCP_HOST": "127.0.0.1",
        "SKETCHUP_MCP_PORT": "9876",
        "SKETCHUP_MCP_TIMEOUT": "60"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

create_componentсоздаёт куб, цилиндр, конус или сферу

transform_componentдвигает, вращает, масштабирует

delete_componentудаляет компонент

set_materialкрасит материалом или цветом

boolean_operationобъединяет и вычитает тела

chamfer_edgeснимает фаску

fillet_edgeскругляет рёбра

create_mortise_tenonделает соединение шип-паз

create_dovetailделает ласточкин хвост

create_finger_jointделает ящичное соединение

get_model_infoчитает сведения о модели

list_componentsперечисляет компоненты

get_component_infoчитает свойства компонента

find_componentsищет компоненты

get_selectionчитает выделение

list_layersперечисляет слои

get_viewport_screenshotснимает вьюпорт в PNG

export_sceneвыгружает сцену в STL, OBJ, DAE

undoотменяет последний вызов

eval_rubyвыполняет любой код Ruby

Показано 20 из 22.

Исходный проект по образцу Blender MCP: 8 базовых инструментов и eval_ruby, пакет sketchup-mcp в PyPI.

Как подключить

Что сделать до подключения

uv: команда uvx скачает пакет sketchup-mcp из PyPI

Скачать или собрать файл .rbz, поставить его через Window → Extension Manager → Install Extension и перезапустить SketchUp

Запустить мост: Extensions → SketchupMCP → Start Server, порт 9876

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio sketchup-mcp \
  -- uvx sketchup-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.sketchup-mcp]
command = "uvx"
args = ["sketchup-mcp"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "sketchup-mcp": {
      "command": "uvx",
      "args": ["sketchup-mcp"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "sketchup-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["sketchup-mcp"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "sketchup-mcp": {
      "command": "uvx",
      "args": ["sketchup-mcp"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "sketchup-mcp": {
      "command": "uvx",
      "args": ["sketchup-mcp"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "sketchup-mcp": {
        "type": "local",
        "command": ["uvx", "sketchup-mcp"]
      }
    }
  }
}

{
  "mcpServers": {
    "sketchup-mcp": {
      "command": "uvx",
      "args": ["sketchup-mcp"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "sketchup-mcp": {
      "command": "uvx",
      "args": ["sketchup-mcp"]
    }
  }
}

Инструменты сервера

get_scene_infoчитает сведения о сцене

get_selected_componentsчитает выделенные компоненты

create_componentсоздаёт компонент

delete_componentудаляет компонент

transform_componentдвигает, вращает, масштабирует

set_materialназначает материал

export_sceneвыгружает сцену

eval_rubyвыполняет любой код Ruby

Сервер вместе со скиллом для Codex и PipClaw на Windows: строит редактируемую модель здания по фото, CAD или тексту по шагам, с транзакциями, откатом и сверкой с исходными картинками.

Как подключить

Что сделать до подключения

Windows, Node.js 18 или новее, Python 3.10 или новее

Скачать из папки dist два ZIP одной сборки 0.5.39: MCP и скилл; скилл положить в $CODEX_HOME/skills/

Поставить su_mcp.rbz из пакета через Extension Manager и перезапустить SketchUp

При первом запуске назвать агенту точный путь к SketchUp.exe

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio adai-sketchup-skill-mcp \
  -- node '<абсолютный путь к папке MCP>/launch.cjs'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.adai-sketchup-skill-mcp]
command = "node"
args = ["<абсолютный путь к папке MCP>/launch.cjs"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "adai-sketchup-skill-mcp": {
      "command": "node",
      "args": ["<абсолютный путь к папке MCP>/launch.cjs"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "adai-sketchup-skill-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["<абсолютный путь к папке MCP>/launch.cjs"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "adai-sketchup-skill-mcp": {
      "command": "node",
      "args": ["<абсолютный путь к папке MCP>/launch.cjs"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "adai-sketchup-skill-mcp": {
      "command": "node",
      "args": ["<абсолютный путь к папке MCP>/launch.cjs"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "adai-sketchup-skill-mcp": {
        "type": "local",
        "command": ["node", "<абсолютный путь к папке MCP>/launch.cjs"]
      }
    }
  }
}

{
  "mcpServers": {
    "adai-sketchup-skill-mcp": {
      "command": "node",
      "args": ["<абсолютный путь к папке MCP>/launch.cjs"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "adai-sketchup-skill-mcp": {
      "command": "node",
      "args": ["<абсолютный путь к папке MCP>/launch.cjs"]
    }
  }
}

Инструменты сервера

sketchup_runtimeпривязывает и запускает SketchUp

sketchup_project_beginзаводит проект модели

sketchup_project_stepвыполняет шаг построения

sketchup_project_geometry_diagnoseнаходит объекты для правки

sketchup_project_retry_evidenceпереснимает виды без перестройки

sketchup_project_reviewзаписывает итог проверки

sketchup_project_recoverвосстанавливает после сбоя записи

sketchup_project_finishсдаёт готовый SKP

Что попросить агента

«Создай обеденный стол 1,2 × 0,8 м высотой 760 мм с отделкой под дуб»sketchup-mcp2 соберёт столешницу и ножки через create_component и покрасит их set_material

«Сделай выбранный компонент красным и подними его на 100 мм»Агент прочитает выделение get_selection, вызовет set_material и transform_component

«Выгрузи сцену в STL для 3D-печати»Агент вызовет export_scene с форматом stl

«Собери небольшой шкаф в стиле arts and crafts с соединениями «ласточкин хвост»»Агент построит корпус через create_component, соединит детали create_dovetail или напишет код для eval_ruby

«Построй редактируемую модель здания по этим фото, SketchUp лежит в <путь к SketchUp.exe>»ADAI привяжет программу через sketchup_runtime, заведёт проект sketchup_project_begin, пройдёт шаги sketchup_project_step с проверкой sketchup_project_review и сдаст файл sketchup_project_finish

Для каких задач

Собрать мебель или простой дом по словесному описанию с размерами в миллиметрах

Перекрасить или подвинуть выделенные компоненты

Сделать фаски, скругления, шипы и ласточкины хвосты на деталях

Выгрузить сцену в STL для 3D-печати или в OBJ и DAE

Построить редактируемую модель здания по фотографиям или CAD

Ограничения

eval_ruby выполняет любой Ruby с доступом к файлам, сети и командной строке, а порт моста без пароля; в sketchup-mcp2 он включён по умолчанию и выключается в Plugins → MCP Server → Settings

SketchupMCP от mhyrr не обновлялся с апреля 2026 года, готового .rbz в релизах нет

ADAI рассчитан на Codex и PipClaw под Windows, проверялся в основном на SketchUp 2019; другие клиенты и SketchUp 2021+ авторы не проверяли, звёзд у проекта 108

Снимок вьюпорта get_viewport_screenshot в sketchup-mcp2 работает только в SketchUp 2026 и новее

Если не работает

Ошибка «SketchUp not running or extension not started»

Сервер не нашёл мост на порту: откройте SketchUp и запустите Plugins → MCP Server → Start Server. Следующий вызов сам подключится заново.

IncompatibleVersionError при подключении

Одна сторона устарела. Обновите пакет командой uvx sketchup-mcp2@latest и перезапустите клиент, либо поставьте свежий .rbz со страницы Releases.

Долгая операция падает по таймауту

Поднимите SKETCHUP_MCP_TIMEOUT в env, держите его заметно выше 30 секунд. Перед повтором проверьте модель через get_component_info или list_components: правка могла примениться.

SketchUp замирает на большом запросе

Большой код в eval_ruby или бесконечный цикл держат SketchUp до конца выполнения. Разбейте работу на несколько вызовов поменьше.

Клиент пишет «connection timed out after 30000ms» при старте

Виртуальное окружение лежит на медленной сетевой или общей папке. Перенесите его на локальный диск через UV_PROJECT_ENVIRONMENT; запуск через uvx sketchup-mcp2 этим не страдает.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
MCP Server for SketchUp (sketchup-mcp2)	zinin	60	локально	не нужен	22	12 ноября 2026
SketchupMCP	mhyrr	546	локально	не нужен	8	25 апреля 2026
ADAI SketchUp MCP + Skill	ADAI (laowang-wy)	108	локально	не нужен	8	9 ноября 2026

Частые вопросы

Какой из трёх серверов выбрать?

Для любого клиента вроде Claude Code или Cursor берите sketchup-mcp2: у него больше инструментов, размеры в миллиметрах и откат каждого вызова. SketchupMCP от mhyrr — исходный вариант с 8 инструментами. ADAI нужен, если вы работаете в Codex на Windows и строите здания по фотографиям.

Опасен ли инструмент eval_ruby?

Он запускает любой код Ruby внутри SketchUp с полным доступом к файлам, сети и командной строке. Claude Code и Claude Desktop показывают код перед запуском и ждут подтверждения. В sketchup-mcp2 его можно выключить галочкой Enable Ruby evaluation в настройках расширения.

SketchUp на Windows, а агент в Linux-виртуалке — как связать?

Оставьте мост на 127.0.0.1 и запустите на Windows SSH-туннель: ssh -N -R 9876:127.0.0.1:9876 user@linux-vm. Сервер в виртуалке подключится к 127.0.0.1:9876, как к локальному SketchUp.

В каких единицах агент задаёт размеры?

В sketchup-mcp2 все размеры в миллиметрах, углы в градусах. У ADAI типовые операции тоже в миллиметрах, а прямые вызовы Ruby API SketchUp идут в дюймах.

Как подключить SketchUp MCP к Claude Code?

Поставьте расширение .rbz и запустите Plugins → MCP Server → Start Server. Затем добавьте сервер с командой uvx sketchup-mcp2 в .mcp.json проекта или возьмите готовую команду во вкладке Claude Code в блоке «Как подключить».

Где скачать расширение SketchUp MCP?

Для sketchup-mcp2 готовый подписанный .rbz лежит на странице Releases репозитория zinin/sketchup-mcp2. У ADAI архивы MCP и скилла лежат в папке dist, файл su_mcp.rbz внутри пакета MCP.

Работает ли сервер из России?

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

SketchUp MCP: три сервера и подключение к Claude Code, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы