RhinoMCP: un servidor MCP para Rhino 3D

105 herramientas para modelado 3D, análisis, diagnóstico e integración con Grasshopper impulsados por IA a través del Model Context Protocol.

RhinoMCP conecta Claude con Rhino 3D mediante un conjunto completo de herramientas que cubren desde primitivas básicas hasta modelado avanzado de superficies (loft, barrido, revolución), operaciones booleanas, diagnóstico de mallas, gestión de bloques y diseño paramétrico con Grasshopper.

Arquitectura

┌────────────────┐   stdio    ┌──────────────┐   TCP/JSON    ┌──────────────┐
│ Claude Desktop │◄──────────►│  rhino_mcp   │◄─────────────►│    Rhino 3D  │
│                │   (MCP)    │  (Python)    │  localhost:   │  listener.py │
│                │            │  server.py   │    9876       │  (inside     │
└────────────────┘            └──────────────┘               │   Rhino)     │
                                                             └──────────────┘

Servidor MCP (rhino_mcp/). Paquete de Python que usa FastMCP. Se comunica con Claude mediante stdio y con Rhino mediante TCP.

Listener de Rhino (rhino/listener.py). Script de Python que se ejecuta dentro de Rhino. Abre un servidor TCP, recibe comandos JSON, los ejecuta usando RhinoCommon/rhinoscriptsyntax y devuelve los resultados.

Related MCP server: Grasshopper MCP

Capacidades

Creación de geometría (21 herramientas)

Transformaciones (8 herramientas)

move, rotate, scale, scale_non_uniform, mirror, copy, array_linear, array_polar

Operaciones booleanas (3 herramientas)

boolean_union, boolean_difference, boolean_intersection

Modificación (18 herramientas)

Bloques e instancias (4 herramientas)

create_block, insert_block, list_blocks, explode_block

Datos de usuario (2 herramientas)

set_user_text, get_user_text: almacenar metadatos, datos BIM, costos, etc.

Capas (6 herramientas)

list_layers, create_layer, delete_layer, set_layer_color, set_layer_visibility, set_current_layer

Materiales (3 herramientas)

list_materials, create_material, assign_material

Análisis (10 herramientas)

Diagnóstico (4 herramientas)

Vista (5 herramientas)

zoom_extents, set_view, capture_view (con opción base64), list_views, set_display_mode

Grasshopper (3 herramientas)

gh_run_script, gh_set_slider, gh_get_outputs

Ejecución de código (2 herramientas)

run_python, run_command: acceso completo a rhinoscriptsyntax y RhinoCommon

Deshacer/Rehacer (2 herramientas)

undo, redo

Escena (4 herramientas)

scene_info, get_objects, get_object (detallado con información de bordes), select_objects

Importar/Exportar (2 herramientas)

export (.3dm, .obj, .stl, .step, .iges, .fbx), import_file

Negrita = nuevo en v2.0

Requisitos previos

• Rhino 7 u 8 (Windows o Mac)

• Python 3.10+

• uv gestor de paquetes (instalación)

Instalación

1. Clonar e instalar

git clone https://github.com/kbangaru-cyber/rhino-mcp.git
cd Rhino_MCP
uv sync

2. Iniciar el listener de Rhino

En Rhino:

1. Ve a Tools > PythonScript > Run

2. Selecciona rhino/listener.py

3. Deberías ver:

============================================================
  RhinoMCP Listener v2.0.0
  Listening on 127.0.0.1:9876
  Registered handlers: 90
  Ready for MCP connection (Claude)
============================================================

3. Configurar Claude Desktop

Claude Desktop

Edita claude_desktop_config.json:

{
  "mcpServers": {
    "rhino": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/Rhino_MCP", "run", "rhino-mcp"],
      "env": {
        "RHINO_MCP_HOST": "127.0.0.1",
        "RHINO_MCP_PORT": "9876",
        "RHINO_MCP_TIMEOUT": "30"
      }
    }
  }
}

Ejemplos de uso

Crear una forma de edificio simple

"Crea una caja de 10x8x4 metros para el volumen del edificio, luego añade un cilindro de radio 2 y altura 6 en el centro para una torre. Únelos y redondea todos los bordes con radio 0.3."

Diagnosticar problemas del modelo

"Comprueba todos los objetos de la escena en busca de problemas. Encuentra bordes abiertos y dime qué hay que corregir."

Diseño paramétrico

"Crea una forma de jarrón haciendo una curva de perfil y revolucionándola. Luego crea una matriz polar de cilindros decorativos a su alrededor."

Prompts integrados

RhinoMCP incluye prompts de flujo de trabajo guiados:

• model-from-description: flujo de trabajo estructurado para crear modelos 3D a partir de descripciones de texto

• diagnose-model: enfoque sistemático para encontrar y corregir problemas del modelo

• parametric-design: guía para flujos de trabajo paramétricos/Grasshopper

Recursos

El servidor expone datos en vivo como recursos MCP:

Configuración

Desarrollo

# Install dev dependencies
uv sync --extra dev

# Run tests (no Rhino needed)
uv run pytest -v

# Lint
uv run ruff check .

# Type check
uv run mypy rhino_mcp

Pruebas de integración

Con Rhino en ejecución y el listener activo:

uv run pytest -v -m integration

Protocolo

Los comandos son objetos JSON enviados a través de TCP (delimitados por nueva línea):

{"id": "abc123", "action": "create_sphere", "params": {"center": [0,0,0], "radius": 5}}

Respuestas:

{"id": "abc123", "ok": true, "result": {"guid": "d3e4f5..."}}

Seguridad de hilos

El listener de Rhino usa Rhino.RhinoApp.InvokeOnUiThread() en Rhino 8+ para garantizar que todas las operaciones de geometría se ejecuten en el hilo de la interfaz de usuario. En Rhino 7, las operaciones se ejecutan directamente (lo cual es seguro para conexiones de un solo cliente).

Licencia

MIT. Consulta LICENSE.

Autor

Karthick Raja B G, portafolio · GitHub

Trabajo relacionado: SPIDER, un complemento de Grasshopper para geometría computacional y análisis espacial.