SketchupMCP - Sketchup Model Context Protocol Integration

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

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

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

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

• "Create a simple house model with a roof and windows"

• "Select all components and get their information"

• "Make the selected component red"

• "Move the selected component 10 units up"

• "Export the current scene as a 3D model"

• "Create a complex arts and crafts cabinet using Ruby code"

Troubleshooting

• Connection issues: Make sure both the Sketchup extension server and the MCP server are running

• Command failures: Check the Ruby Console in Sketchup for error messages

• Timeout errors: Try simplifying your requests or breaking them into smaller steps

Technical Details

Communication Protocol

• Commands are sent as JSON objects with a type and optional params

• Responses are JSON objects with a status and result or message

Contributing

License

SketchupMCP - Sketchup Model Context Protocol Integration

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

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

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

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

• "Create a simple house model with a roof and windows"

• "Select all components and get their information"

• "Make the selected component red"

• "Move the selected component 10 units up"

• "Export the current scene as a 3D model"

• "Create a complex arts and crafts cabinet using Ruby code"

Troubleshooting

• Connection issues: Make sure both the Sketchup extension server and the MCP server are running

• Command failures: Check the Ruby Console in Sketchup for error messages

• Timeout errors: Try simplifying your requests or breaking them into smaller steps

Technical Details

Communication Protocol

• Commands are sent as JSON objects with a type and optional params

• Responses are JSON objects with a status and result or message

Contributing

License