SketchupMCP는 모델 컨텍스트 프로토콜(MCP)을 통해 Sketchup과 Claude AI를 연결하여 Claude가 Sketchup과 직접 상호작용하고 제어할 수 있게 합니다. 이 통합은 Sketchup에서 프롬프트 지원 3D 모델링, 장면 생성 및 조작을 가능하게 합니다.

영감과 구조를 제공해준 Blender MCP에게 큰 감사를 전합니다.

특징

• 양방향 통신: TCP 소켓 연결을 통해 Claude AI와 Sketchup 연결
• 컴포넌트 조작: Sketchup에서 컴포넌트를 생성, 수정, 삭제, 변환
• 재료 제어: 재료와 색상을 적용하고 수정하기
• 씬 점검: 현재 Sketchup 씬에 대한 자세한 정보를 확인하세요
• 선택 처리: 선택된 구성 요소를 얻고 조작합니다
• Ruby 코드 평가: 고급 작업을 위해 임의의 Ruby 코드를 SketchUp에서 직접 실행하세요

구성 요소

이 시스템은 두 가지 주요 구성 요소로 구성되어 있습니다:

1. Sketchup 확장: Sketchup 내에서 명령을 수신하고 실행하는 TCP 서버를 생성하는 Sketchup 확장
2. MCP 서버 (sketchup_mcp/server.py): 모델 컨텍스트 프로토콜을 구현하고 Sketchup 확장에 연결하는 파이썬 서버

설치

파이썬 패키징

SketchupMCP - Sketchup Model Context Protocol Integration

SketchupMCP connects Sketchup to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Sketchup. This integration enables prompt-assisted 3D modeling, scene creation, and manipulation in Sketchup.

Big Shoutout to Blender MCP for the inspiration and structure.

Features

• Two-way communication: Connect Claude AI to Sketchup through a TCP socket connection
• Component manipulation: Create, modify, delete, and transform components in Sketchup
• Material control: Apply and modify materials and colors
• Scene inspection: Get detailed information about the current Sketchup scene
• Selection handling: Get and manipulate selected components
• Ruby code evaluation: Execute arbitrary Ruby code directly in SketchUp for advanced operations

Components

The system consists of two main components:

1. Sketchup Extension: A Sketchup extension that creates a TCP server within Sketchup to receive and execute commands
2. MCP Server (sketchup_mcp/server.py): A Python server that implements the Model Context Protocol and connects to the Sketchup extension

Installation

Python Packaging

We’re using uv so you’ll need to brew install uv

Sketchup Extension

1. Download or build the latest .rbz file
2. In Sketchup, go to Window > Extension Manager
3. Click “Install Extension” and select the downloaded .rbz file
4. Restart Sketchup

Usage

Starting the Connection

1. In Sketchup, go to Extensions > SketchupMCP > Start Server
2. The server will start on the default port (9876)
3. Make sure the MCP server is running in your terminal

Using with Claude

Configure Claude to use the MCP server by adding the following to your Claude configuration:

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

This will pull the latest from PyPI

Once connected, Claude can interact with Sketchup using the following capabilities:

Tools

• get_scene_info - Gets information about the current Sketchup scene
• get_selected_components - Gets information about currently selected components
• create_component - Create a new component with specified parameters
• delete_component - Remove a component from the scene
• transform_component - Move, rotate, or scale a component
• set_material - Apply materials to components
• export_scene - Export the current scene to various formats
• eval_ruby - Execute arbitrary Ruby code in SketchUp for advanced operations

Example Commands

Here are some examples of what you can ask Claude to do:

• “Create a simple house model with a roof and windows”
• “Select all components and get their information”
• “Make the selected component red”