ZS

zinin/sketchup-mcp2

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

56 stars 7 forks Качество 83 Тренд 34MIT

MCP сервер для SketchUp

Обзор

Подключите Claude (или любого клиента с ИИ, осведомленного о MCP) к SketchUp для быстрого 3D-моделирования. - (sketchup-mcp2 на PyPI) - предоставляет типизированные инструменты для LLM через протокол Model Context. Запускает TCP-сервер внутри SketchUp и выполняет команды против живой модели. Или возьмите последний .rbz со страницы Релизов или создайте его из источника: В SketchUp: Window → Extension Manager → Install Extension, выберите .rbz, перезапустите SketchUp. Плагин поставляется с eval ruby — произвольным исполнением Ruby внутри SketchUp — ; отключение проверки в плагинах → MCP Server → Настройки ... для закрытия ворот. Плагины → MCP Server → Start Server — по умолчанию прослушивает 127.0.0.1:9876. Для Claude Code / Claude Desktop добавьте в .mcp.json (или claude desktop config.json): uvx автоматически вытащит sketchup-mcp2 из PyPI — установите uv, если у вас его нет. Вот так. Спросите Клода о таких вещах, как «создать обеденный стол с дубом 1,2×0,8 м» и посмотрите, как это происходит.

Обзор (машинный перевод)

Подключите Claude (или любого клиента с ИИ, осведомленного о MCP) к SketchUp для быстрого 3D-моделирования.

Двухпроцессный мост:

  • Python MCP-сервер ([T0]] на PyPI) - предоставляет набранные инструменты LLM через протокол Model Context. Расширение Ruby SketchUp — запускает TCP-сервер внутри SketchUp и выполняет команды против живой модели.

##Быстрый старт

###1 Установите расширение SketchUp

Либо выберите последнюю .rbz со страницы Релизов, либо создайте ее из источника:

[[Т2]], выберите [[Т3]], перезапустите SketchUp. Плагин поставляется с eval_ruby — произвольным исполнением Ruby внутри SketchUp — ** с поддержкой по умолчанию **; непроверяемый ** Включить оценку Ruby ** в Plugins → MCP Server → Settings..., чтобы закрыть ворота.

###2 Запустите сервер в SketchUp

[6] — по умолчанию слушает [7].

###3 Настройка клиента MCP

Для Claude Code / Claude Desktop добавьте .mcp.json (или claude_desktop_config.json):

uvx вытащит sketchup-mcp2 из PyPI автоматически — установите uv, если у вас его нет.

Вот так. Спросите Клода о таких вещах, как «создать 1,2×0».

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

MCP Server for SketchUp

Connect Claude (or any MCP-aware AI client) to SketchUp for prompt-driven 3D modeling.

Two-process bridge:

  • Python MCP server (sketchup-mcp2 on PyPI) — exposes typed tools to the LLM via the Model Context Protocol.
  • Ruby SketchUp extension — runs a TCP server inside SketchUp and executes commands against the live model.

Quickstart

1. Install the SketchUp extension

Either grab the latest .rbz from the Releases page or build it from source:

gem install --user-install rubyzip
(cd mcp_for_sketchup && ruby package.rb)
# → mcp_for_sketchup/mcp_for_sketchup_v.rbz

In SketchUp: Window → Extension Manager → Install Extension, pick the .rbz, restart SketchUp. The plugin ships with eval_ruby — arbitrary Ruby execution inside SketchUp — enabled by default; uncheck Enable Ruby evaluation in Plugins → MCP Server → Settings... to close the gate.

2. Start the server inside SketchUp

Plugins → MCP Server → Start Server — by default listens on 127.0.0.1:9876.

3. Configure your MCP client

For Claude Code / Claude Desktop, add to .mcp.json (or claude_desktop_config.json):

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

uvx will pull sketchup-mcp2 from PyPI automatically — install uv if you don’t have it.

That’s it. Ask Claude things like “create a 1.2 × 0.8 m oak dining table” and watch it happen.

Features

Tool catalogue

Category Tools
Geometry create_component (cube / cylinder / cone / sphere), delete_component, transform_component — all dimensions in mm; position is an absolute bbox-min target
Materials set_material — paints a group, component instance, face or edge with an existing material (by name), a named color or hex #rrggbb
Booleans boolean_operation — union / difference / intersection
Edge ops chamfer_edge, fillet_edge — feature edges only (seams and concave edges skipped; fillet also skips curved rims and refuses a body without straight feature edges); distance/radius in mm, segments configurable
Joinery create_mortise_tenon, create_dovetail, create_finger_joint
Export export_scene — skp / obj / dae / stl / png / jpg; skp is refused for an untitled model
Открыть полный README на GitHub

Установка

uvx sketchup-mcp2
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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