Connect Claude (또는 MCP-aware AI 클라이언트)를 SketchUp으로 프롬프트 구동 3D 모델링.

2 과정 교량:

• Python MCP 서버 (sketchup-mcp2] on PyPI) - 모델 Context 프로토콜을 통해 LLM에 Typed 도구를 노출합니다.
• Ruby SketchUp extension - SketchUp 내부 TCP 서버를 실행하고 라이브 모델에 대한 명령을 실행합니다.

퀵스타트

##1. 스케치업 확장 설치

릴리스 페이지에서 최신 .rbz을 잡아 또는 소스에서 구축:

스케치업에서: Window → Extension Manager → Install Extension, .rbz], 재시작 스케치업. 플러그인은 eval_ruby] - SketchUp 내부의 임베디드 루비 실행 - ** 기본적으로 활성화 ; uncheckEnable Ruby assessment** in Plugins → MCP Server → Settings... 문 닫기.

##2. SketchUp 내부 서버 시작

Plugins → MCP Server → Start Server - 기본적으로 127.0.0.1:9876]을 듣는다.

##3. MCP 클라이언트 구성

Claude Code / Claude 데스크톱의 경우 .mcp.json]에 추가하십시오 (또는 claude_desktop_config.json) :

uvx]는 PyPI에서 sketchup-mcp2을 자동으로 끌어 당깁니다. uv를 설치하면 안됩니다.

그게 다. * "1.2 × 0을 작성하는 것과 같은 클레드 것들을 묻습니다.

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