SketchupMCP - Integración del protocolo de contexto del modelo de Sketchup

SketchupMCP conecta Sketchup con la IA de Claude mediante el Protocolo de Contexto de Modelo (MCP), lo que permite a Claude interactuar directamente con Sketchup y controlarlo. Esta integración facilita el modelado 3D, la creación de escenas y la manipulación asistida por comandos en Sketchup.

Un gran agradecimiento a Blender MCP por la inspiración y la estructura.

Características

• Comunicación bidireccional : conecta Claude AI a Sketchup a través de una conexión de socket TCP
• Manipulación de componentes : crear, modificar, eliminar y transformar componentes en SketchUp
• Control de materiales : aplicar y modificar materiales y colores
• Inspección de escena : obtenga información detallada sobre la escena actual de Sketchup
• Manejo de selección : obtener y manipular los componentes seleccionados
• Evaluación de código Ruby : ejecute código Ruby arbitrario directamente en SketchUp para operaciones avanzadas

Componentes

El sistema consta de dos componentes principales:

1. Extensión de Sketchup : una extensión de Sketchup que crea un servidor TCP dentro de Sketchup para recibir y ejecutar comandos
2. Servidor MCP ( sketchup_mcp/server.py ) : un servidor Python que implementa el Protocolo de contexto de modelo y se conecta a la extensión Sketchup

Instalación

Empaquetado de Python

Estamos usando uv, por lo que necesitarás brew install uv

Extensión de SketchUp

1. Descargue o cree el último archivo .rbz
2. En Sketchup, vaya a Ventana > Administrador de extensiones
3. Haga clic en "Instalar extensión" y seleccione el archivo .rbz descargado
4. Reiniciar SketchUp

Uso

Iniciando la conexión

1. En Sketchup, vaya a Extensiones > SketchupMCP > Iniciar servidor
2. El servidor se iniciará en el puerto predeterminado (9876)
3. Asegúrese de que el servidor MCP se esté ejecutando en su terminal

Usando con Claude

Configure Claude para usar el servidor MCP agregando lo siguiente a su configuración de Claude:

Esto extraerá lo último de PyPI

Una vez conectado, Claude puede interactuar con Sketchup utilizando las siguientes capacidades:

Herramientas

• get_scene_info : obtiene información sobre la escena actual de Sketchup
• get_selected_components : obtiene información sobre los componentes seleccionados actualmente
• create_component - Crea un nuevo componente con parámetros especificados
• delete_component - Eliminar un componente de la escena
• transform_component - Mover, rotar o escalar un componente
• set_material - Aplicar materiales a los componentes
• export_scene - Exporta la escena actual a varios formatos
• eval_ruby : ejecuta código Ruby arbitrario en SketchUp para operaciones avanzadas

Comandos de ejemplo

Aquí hay algunos ejemplos de lo que puedes pedirle a Claude que haga:

• "Crea un modelo de casa simple con techo y ventanas"
• "Seleccione todos los componentes y obtenga su información"
• "Hacer que el componente seleccionado sea rojo"
• "Mover el componente seleccionado 10 unidades hacia arriba"
• "Exportar la escena actual como modelo 3D"
• Crea un gabinete de manualidades complejo con código Ruby.

Solución de problemas

• Problemas de conexión : asegúrese de que tanto el servidor de extensión de Sketchup como el servidor MCP estén en ejecución
• Errores de comando : Verifique la consola Ruby en Sketchup para ver si hay mensajes de error
• Errores de tiempo de espera : intente simplificar sus solicitudes o dividirlas en pasos más pequeños

Detalles técnicos

Protocolo de comunicación

El sistema utiliza un protocolo simple basado en JSON sobre sockets TCP:

• Los comandos se envían como objetos JSON con un type y params opcionales.
• Las respuestas son objetos JSON con un status y result o message

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Instituto Tecnológico de Massachusetts (MIT)