RhinoMCP

RhinoMCP conecta Rhino3D con Claude AI a través del Protocolo de contexto de modelo (MCP), lo que permite a Claude interactuar directamente con Rhino3D y controlarlo para flujos de trabajo de modelado, análisis y diseño 3D asistidos por IA.

Descripción general del proyecto

Esta integración consta de dos componentes principales:

1. Complemento de Rhino : un servidor de sockets que se ejecuta dentro del editor Python de Rhino y proporciona una interfaz de comunicación para la funcionalidad de Rhino.

2. Servidor MCP : una implementación del Protocolo de contexto de modelo que conecta Claude AI con el complemento de Rhino, lo que permite operaciones controladas por IA.

Related MCP server: SketchupMCP

Características

• Comunicación bidireccional basada en sockets entre Python y Rhino

• Servidor de protocolo de contexto de modelo para la integración de Claude AI

• Soporte para la creación de curvas NURBS (función de prueba inicial)

• Ejecución de scripts de Python en el contexto de Rhino

• Compatible con Claude Desktop y Windsurf como clientes

Instalación

Requisitos

• Rhinoceros 3D (versión 7 u 8)

• Python 3.10 o superior

• Windows 10 o 11

Instalar usando uv (recomendado)

# Create and activate a virtual environment 
mkdir -p .venv
uv venv .venv
source .venv/Scripts/activate  # On Windows with Git Bash

# Install the package
uv pip install -e .

Instalar usando pip

# Create and activate a virtual environment
python -m venv .venv
.venv\Scripts\activate  # On Windows

# Install the package
pip install -e .

Uso

Paso 1: Inicie el servidor Rhino Bridge

1. Abrir Rhino

2. Escriba EditPythonScript en la línea de comando para abrir el editor de Python de Rhino

3. Abra el script del servidor Rhino desde src/rhino_plugin/rhino_server.py

4. Ejecute el script (F5 o haga clic en el botón Ejecutar)

5. Verifique que aparezca "¡Rhino Bridge iniciado!" en el panel de salida

Paso 2: Iniciar el servidor MCP

# Activate your virtual environment
source .venv/Scripts/activate  # On Windows with Git Bash

# Start the MCP server
rhinomcp

O ejecutar con configuraciones personalizadas:

rhinomcp --host 127.0.0.1 --port 5000 --rhino-host 127.0.0.1 --rhino-port 8888 --debug

Paso 3: Conéctese con Claude Desktop o Windsurf

Configure Claude Desktop o Windsurf para conectarse al servidor MCP en:

ws://127.0.0.1:5000

Ejemplo: Creación de una curva NURBS

Cuando se conecta a Claude, puedes pedirle que cree una curva NURBS en Rhino con un mensaje como el siguiente:

Create a NURBS curve in Rhino using points at (0,0,0), (5,10,0), (10,0,0), and (15,10,0).

Desarrollo

Configurar el entorno de desarrollo

# Clone the repository
git clone https://github.com/FernandoMaytorena/RhinoMCP.git
cd RhinoMCP

# Create and activate virtual environment
uv venv .venv
source .venv/Scripts/activate  # On Windows with Git Bash

# Install development dependencies
uv pip install -e ".[dev]"

Ejecutar pruebas

pytest

Estilo de código

Este proyecto utiliza Ruff para corrección de errores y formato:

ruff check .
ruff format .

Estructura del proyecto

RhinoMCP/
├── src/
│   ├── rhino_plugin/  # Code that runs inside Rhino
│   │   └── rhino_server.py
│   └── rhino_mcp/     # MCP server implementation
│       ├── rhino_client.py
│       └── mcp_server.py
├── tests/             # Test modules
├── docs/              # Documentation
├── config/            # Configuration files
├── ai/                # AI documentation and prompts
├── setup.py           # Package installation
├── requirements.txt   # Package dependencies
└── README.md          # Project documentation

Licencia

Licencia MIT

Contribuyendo

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