Sketchup MCP

SketchupMCP connects Sketchup with Claude AI through the Model Context Protocol (MCP) to achieve bidirectional communication and 3D modeling control.

Artificial intelligence chatbots Education and learning tools #3D Modeling #AI Integration #Bidirectional Communication #Ruby Control .Python

rating : 2.5 points

downloads : 20

update time : 2025-04-28

What is SketchupMCP?

SketchupMCP is an innovative integration solution that connects the Sketchup 3D modeling software with the Claude AI intelligent assistant through the Model Context Protocol (MCP). This technology allows users to create, modify, and control 3D models through natural language instructions, greatly simplifying the 3D design process.

How to use SketchupMCP?

The usage process is divided into three simple steps: install the Sketchup extension, start the MCP server, and then send modeling instructions through Claude AI. The system will automatically transform your ideas into 3D models.

Applicable Scenarios

It is particularly suitable for professionals such as architects, product designers, and game developers who need rapid prototyping, and is also suitable for beginners in 3D modeling to learn and use.

Main Features

Bidirectional CommunicationRealize real-time data exchange between Sketchup and AI through TCP sockets

Component OperationCreate, modify, delete, and transform 3D components

Material ControlIntuitively adjust the model material and color

Scene InspectionObtain detailed scene information in real-time

Ruby Code ExecutionSupport the execution of advanced Ruby scripts to achieve complex operations

Advantages and Limitations

Advantages

Create complex 3D models without programming knowledge

Greatly improve modeling efficiency, especially suitable for rapid prototyping

Support interaction through natural language, intuitive and easy to use

Retain all functions of Sketchup while adding AI assistance

Limitations

Basic understanding of Sketchup concepts and terms is required

Complex structures may require step-by-step instructions

Currently only supports cooperation with Claude AI

How to Use

Install the Sketchup Extension

Download the .rbz file and install it through the Extension Manager

Start the MCP Server

Start the TCP server in Sketchup

Configure Claude AI

Add MCP server settings in the Claude configuration

Usage Examples

Rapid House ModelingCreate a basic house structure through simple instructions

Material ReplacementModify the appearance of the model in batches

Complex Structure CreationUse Ruby scripts to generate special structures

Frequently Asked Questions

Why isn't my instruction being executed?

How to view error information?

Which Sketchup versions are supported?

Related Resources

Official GitHub Repository

Original project code repository

Smithery Installation Page

One-click installation service

Sketchup Official Forum

Get help on using Sketchup

🚀 SketchupMCP - Integration of Sketchup Model Context Protocol (MCP)

SketchupMCP connects Sketchup to Claude AI through the Model Context Protocol (MCP), enabling Claude to directly interact with and control Sketchup. This integration allows for prompt-assisted 3D modeling, scene creation, and Sketchup operations.

Special thanks to mhyrr/sketchup-mcp for providing the architecture. We have translated its native version (mhyrr/sketchup-mcp) into Traditional Chinese and optimized and adjusted some functions.

✨ Features

Bidirectional Communication: Connect Claude AI and Sketchup via TCP sockets.
Component Operations: Create, modify, delete, and transform components in Sketchup.
Material Control: Apply and modify materials and colors.
Scene Inspection: Obtain detailed information about the current Sketchup scene.
Selection Handling: Get and manipulate selected components.
Ruby Code Execution: Execute arbitrary Ruby code directly in Sketchup for advanced operations.

📦 Components

The system consists of two main components:

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

📦 Installation

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

Installation Steps

Download and install the SketchupMCP extension.
Start Sketchup and launch the MCP server:
```
pip install uv
```

💻 Usage Examples

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

Basic Usage

"Create a simple house model with a roof and windows."
"Select all components and get their information."
"Change the selected components to red."
"Move the selected components up by 10 units."
"Export the current scene as a 3D model."
"Use Ruby code to create a complex Arts and Crafts cabinet."

📚 Documentation

Troubleshooting

Connection Issues: Ensure that both the Sketchup extension server and the MCP server are running.
Command Execution Failure: Check Sketchup's Ruby console for error messages.
Timeout Errors: Try simplifying requests or splitting operations into smaller steps.

🔧 Technical Details

Communication Protocol

The system uses a simple JSON protocol based on TCP sockets:

Commands are sent as JSON objects, containing type and optional params.
Responses are returned as JSON objects, containing status and result or message.