SketchUp MCP
Provides tools for interacting with a desktop SketchUp model through a local Ruby bridge, enabling scene and selection queries, geometry creation, transformations, material assignment, deletion, export, and capture, with a simulated mode when SketchUp is unavailable.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SketchUp MCP check SketchUp status and add a 2m cube at the origin"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SketchUp MCP
Servidor MCP local para SketchUp de escritorio. Funciona con clientes que pueden iniciar servidores MCP por stdio. Incluye una extensión Ruby instalable y un modo simulado para probar el flujo desde Linux.
flowchart LR
A["Cliente MCP"] -->|stdio| B["Servidor Python"]
B -->|"TCP local · puerto 9876"| C["Extensión Ruby en SketchUp"]
B -->|"Sin conexión al puente"| D["Escena simulada · JSON"]Primeros pasos
Necesitas Python 3.10 o posterior. Crea un entorno virtual para este proyecto. Para empezar con el modo simulado, instala solo el servidor.
python3 -m venv .venv
.venv/bin/python -m pip install -e .Related MCP server: CDT-SketchUp
Configurar tu cliente MCP
Agrega un servidor local con transporte stdio y usa la ruta absoluta del ejecutable instalado. El cliente inicia el proceso.
Campo | Valor |
Nombre |
|
Comando en Linux y macOS |
|
Comando en Windows |
|
Argumentos | Ninguno |
Ejemplo para Cursor en mcp.json. Ajusta la ruta antes de guardar.
{
"mcpServers": {
"sketchup": {
"type": "stdio",
"command": "/ruta/al/proyecto/.venv/bin/mcp-sketchup"
}
}
}Usa el mismo ejecutable al configurar otros clientes que admitan stdio. Cursor · VS Code con Copilot · OpenCode
Ejecuta sketchup_status desde tu cliente para saber si estás trabajando con SketchUp o con la escena simulada.
Conectar SketchUp
Descarga su_mcp_bridge.rbz e instálalo con Extension Manager en SketchUp de escritorio. También puedes generar el archivo con
./build_rbz.sh.Abre o crea una escena. La extensión inicia el puente local al cargarse. Puedes controlarlo en Extensions → SketchUp MCP Bridge - Start Server / Stop Server.
Verifica la conexión con
sketchup_status. El puente escucha en127.0.0.1:9876.
Variante local en Arch Linux
La variante usa SketchUp Make 2017 de 64 bits en un prefijo de Wine separado. El script instala el puente en la carpeta Plugins de esa instalación y abre SketchUp.
./install_sketchup_arch.sh
# Si ya tienes el instalador y quieres preparar el prefijo:
./install_sketchup_arch.sh /ruta/al/instalador.exePara una instalación en otra ruta, configura WINEPREFIX o SKETCHUP_EXE. El instalador de SketchUp se obtiene por separado. Make 2017 es una versión histórica y Wine es una ruta experimental. Compatibilidad oficial.
Herramientas y alcance
Operación | Puente Ruby incluido | Modo simulado |
Estado, escena y selección | Consulta el modelo abierto | Consulta una escena JSON persistente |
Crear geometría | Crea un grupo con geometría de caja | Guarda posición, dimensiones y tipo |
Transformar, aplicar materiales y borrar | Requiere un puente que implemente esos comandos | Actualiza la escena simulada |
Exportar | Requiere un puente que implemente exportación | JSON y OBJ simplificado |
Captura | Requiere una vista de SketchUp | Devuelve el estado de la simulación |
El SDK publica 12 herramientas. La simulación conserva sus datos en ~/.cache/sketchup-mcp por defecto. SKETCHUP_MCP_CACHE permite usar otra carpeta y SKETCHUP_MCP_HOST / SKETCHUP_MCP_PORT configuran la conexión del servidor. Para el puente incluido, conserva la dirección local. El puente admite ejecución de Ruby dentro de SketchUp y está diseñado para clientes de confianza en el mismo equipo.
En Linux se comprobaron las 12 herramientas registradas y el flujo simulado desde el SDK MCP por stdio. SketchUp Make 2017 abrió la pantalla de bienvenida con Wine. Quedan pendientes la validación individual en los clientes listados y la prueba del puente con una escena abierta. SketchUp Web carece de conexión con esta extensión de escritorio.
El protocolo incorpora compatibilidad con mhyrr/sketchup-mcp y Shattenjagger/sketchup-mcp-bridge. Consulta el historial de cambios.
El código se distribuye bajo la licencia MIT. Se conserva el aviso de la referencia MIT del puente.
Available Tools
12 toolsclear_sceneA
Limpia la escena mock (borra todos los componentes). No afecta SketchUp vivo.
Inputs: no named parameters. Returns: result
create_componentC
Crea un componente en la escena. Tipos: cube, sphere, cylinder, face, custom. Position/size como 'x,y,z'.
Inputs: name (required), size, material, position, +1 more. Returns: result
delete_componentC
Borra componente por id o nombre.
Inputs: id_or_name (required). Returns: result
eval_rubyB
Ejecuta Ruby arbitrario en SketchUp. Si no hay SketchUp, mockea con info.
Inputs: code (required). Returns: result
export_sceneC
Exporta escena mock o pide a SketchUp que exporte. Formatos: json, obj, skp, glb.
Inputs: path, format. Returns: result
get_scene_infoB
Info de la escena actual — intenta SketchUp, fallback a mock.
Inputs: no named parameters. Returns: result
get_selected_componentsB
Alias de get_selection para compatibilidad con mhyrr.
Inputs: no named parameters. Returns: result
get_selectionC
Entidades seleccionadas (mock o SketchUp).
Inputs: no named parameters. Returns: result
screenshotB
Captura de SketchUp. Requiere SketchUp vivo y SCREENSHOT_DIR configurado, si no mock.
Inputs: no named parameters. Returns: result
set_materialC
Aplica material/color a componente. Colores: Red, Blue, #ff0000, etc.
Inputs: id_or_name (required), color, material. Returns: result
sketchup_statusA
Estado de conexión a SketchUp + info mock. Usa esto primero.
Inputs: no named parameters. Returns: result
transform_componentC
Mueve/rota/escala componente. Formato: 'x,y,z' para cada uno.
Inputs: id_or_name (required), scale, rotation, translation. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Most tools are clearly separated by resource and action (create_component, transform_component, set_material, export_scene), so the core set is easy to navigate. However, get_selected_components is explicitly an alias of get_selection, meaning two tools have an identical purpose and an agent must guess or arbitrarily choose between them. The status/info/selection trio is also somewhat close in scope (all read-only introspection).
The dominant pattern is a clean verb_noun snake_case convention (create_component, delete_component, transform_component, set_material, export_scene, clear_scene, get_scene_info, get_selection). The deviations are the bare nouns sketchup_status and screenshot, which break the verb-first pattern but remain unambiguous and readable. No camelCase/snake_case mixing, so the set is easy to predict.
Twelve tools is comfortably in the well-scoped range for a 3D scene manipulation server, covering connection, inspection, creation, mutation, and export. Apart from the redundant alias, each tool maps to a distinct operation that earns its place. No sign of tool bloat or a thin surface.
The lifecycle is broadly covered: connect/status, inspect scene and selection, create/delete/transform components, apply materials, evaluate Ruby as an escape hatch, export, screenshot, and clear. Minor gaps remain — there is no explicit list_components or get_component-by-id tool (agents must rely on get_scene_info), and no copy/duplicate or undo operation. These are workaroundable, especially via eval_ruby.
Maintenance
Related MCP Connectors
Headless CAD engine & MCP server for 2D/3D drafting, solids, DXF/SVG export, and automation.
Ovanek MCP: Model Context Protocol server for Ovanek platform tools; writes are dry-run by default.
MCP server for StyleKit styles, tokens, recipes, lint and repair over stdio or HTTP.
MCP server to assist with JxBrowser development.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables controlling SketchUp from MCP-compatible clients via a stdio Python server that bridges to a Ruby plugin, supporting component operations, material assignment, scene export, arbitrary Ruby evaluation, and wood joinery tools.1013MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to inspect and manipulate live SketchUp models through a safe loopback bridge, supporting geometry creation, component/group operations, tags, materials, and transformations with persistent-ID safety.MIT
- AlicenseAqualityCmaintenanceConnects MCP-aware AI clients to a live SketchUp session so models can be built and edited through natural-language prompts. Exposes typed tools for geometry creation, materials, booleans, edge chamfers/fillets, joinery, scene export, model introspection, viewport screenshots, and an optional arbitrary-Ruby escape hatch.24MIT
- AlicenseCqualityBmaintenanceEnables MCP clients to inspect and modify SketchUp models through a local authenticated bridge, covering entity creation and editing, geometry, materials, tags, cameras, scenes, transactions, snapshots, and file or view export. It also offers an optional full SketchUp Ruby API execution channel and batch operations for furniture, architectural, and analysis tasks.371MIT