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:
- 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.
- 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.
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
- Abrir Rhino
- Escriba
EditPythonScript en la línea de comando para abrir el editor de Python de Rhino - Abra el script del servidor Rhino desde
src/rhino_plugin/rhino_server.py - Ejecute el script (F5 o haga clic en el botón Ejecutar)
- 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:
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
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.