Skip to main content
Glama
SketchUp MCP

SketchUp MCP

by camilin7483

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

sketchup

Comando en Linux y macOS

/ruta/al/proyecto/.venv/bin/mcp-sketchup

Comando en Windows

C:\ruta\al\proyecto\.venv\Scripts\mcp-sketchup.exe

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

  1. 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.

  2. 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.

  3. Verifica la conexión con sketchup_status. El puente escucha en 127.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.exe

Para 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 tools
clear_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

    B3.2/5.0

    Scored across 12 tools

    Disambiguation3/5

    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).

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Enables 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.
      10
      13
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      A
      quality
      C
      maintenance
      Connects 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.
      24
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables 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.
      37
      1
      MIT