Rhino 3D

The Rhino MCP Server project enables the interaction between Claude AI and Rhino 3D, supporting the creation and manipulation of 3D objects

Developer tools Image and video processing #3D Modeling #AI Interaction #Rhino Plugin #MCP Protocol .C#

rating : 2.5 points

downloads : 47

update time : 2025-04-28

What is the Rhino MCP Server?

The Rhino MCP Server is a tool based on the Model Context Protocol (MCP) that allows AI assistants like Claude to directly create and modify 3D models through the Rhino 3D software. With this server, you can easily design and adjust complex 3D models.

How to Use the Rhino MCP Server?

Simply follow the simple steps to set up the server and connect it to your AI assistant, and you can start using it. You can interact with the server through command-line input or the graphical interface to quickly generate 3D objects.

Applicable Scenarios

Suitable for scenarios where architects, designers, and engineers need to quickly build complex 3D models, such as architectural design, product prototype design, and engineering visualization.

Main Features

Create GeometrySupports creating various basic geometric shapes such as spheres, cubes, and cylinders.

Scene ManagementCan obtain information about the current scene and clear unnecessary objects.

Layer ManagementAllows creating new layers in the document to better organize objects.

Advantages and Limitations

Advantages

Seamlessly integrates the powerful modeling capabilities of Rhino 3D.

Supports multiple geometry creation and management functions.

Easy to use in conjunction with AI assistants to improve design efficiency.

Limitations

Currently still in the development stage, and there may be some issues where some functions are not fully stable.

Requires a certain technical background to set up and run the server.

How to Use

Install Rhino 3D

Ensure that the latest version of the Rhino 3D software is installed.

Start the MCP Server

Run the script to start the MCP server. It is recommended to use the `combined` mode.

Configure Claude Desktop

Configure the MCP server address in Claude Desktop.

Usage Examples

Create a SphereUse the geometry tool to create a sphere and place it in the scene.

Clean the SceneClear all objects in the current scene to start a new design.

Frequently Asked Questions

What if the server fails to start?

How to view the server logs?

Does it support other languages?

Related Resources

Rhino 3D Official Website

Visit the Rhino 3D official website for more information and support.

GitHub Project Repository

Visit the GitHub repository to view the source code and contribute.

User Manual

Download the user manual to learn more about the usage methods.

🚀 Rhino MCP Server

This project aims to enable AI-assisted 3D modeling in Rhino through the MCP protocol, allowing users to create and manipulate 3D objects via AI assistants like Claude.

⚠️ Important Note

This project is currently under active development and not yet fully operational. There are issues with the Rhino plugin when creating objects.

We are actively seeking community help, especially from developers familiar with the Rhino API, C# plugins, or MCP integration.

🚀 Quick Start

This project is in the development phase. It aims to achieve AI-assisted modeling in Rhino 3D through the MCP protocol, enabling users to create and manipulate 3D objects with an AI assistant (such as Claude). However, there are still some problems, particularly the stability of the plugin during object creation.

✨ Features

1. MCP Server Implementation

combined_mcp_server.py: The core server implementation supports the following tools:
- geometry_tools.create_sphere: Create a sphere with a specified center and radius.
- geometry_tools.create_box: Create a cuboid with specified dimensions.
- geometry_tools.create_cylinder: Create a cylinder with specified parameters.
- scene_tools.get_scene_info: Get information about the current scene.
- scene_tools.clear_scene: Clear all objects in the scene.
- scene_tools.create_layer: Create a new layer in the document.

2. Plugin Development

Rhino Plugin: Responsible for interacting with Rhino. Currently, there are the following issues:
- Object creation fails and requires further debugging and fixing.

📦 Installation

No installation steps provided in the original document.

💻 Usage Examples

No code examples provided in the original document.

📚 Documentation

System Architecture

The project structure is as follows:

Python Scripts:
- combined_mcp_server.py: The main MCP server implementation.
- diagnose_rhino_connection.py: A diagnostic tool for testing the Rhino connection status.
- log_manager.py: Manages log files and provides analysis functions.
Shell Scripts:
- server_launcher.sh: A unified startup script supporting multiple server modes.
Directory Structure:
- logs/: Stores log files for all components.

Log System

The project uses a unified logging framework to record the following:

Server logs.
Plugin logs.
AI workstation logs.
Diagnostic logs.

All logs are stored in the logs/ directory by component and follow a consistent format. Log viewing, analysis, and report generation can be achieved through log_manager.py.

Development Guide

Project Structure

.
├── combined_mcp_server.py       # The main MCP server implementation.
├── diagnose_rhino_connection.py # A diagnostic tool for testing the Rhino connection status.
├── log_manager.py               # A log management tool.
└── server_launcher.sh           # A unified startup script.

Adding New Features

Adding New Tools:
- Add new functional methods to combined_mcp_server.py.
- Ensure compliance with the existing logging specifications.
Diagnosis and Repair:
- Use diagnose_rhino_connection.py to test the connection status between the plugin and Rhino.
- Fix the current object creation issues to ensure the stable operation of the plugin.
Log Management:
- Update the logging framework to support new functional modules.
- Ensure that all log outputs follow a unified format.

Troubleshooting

Common Issues

Connection Failure:
- Check if there are old processes occupying ports or resources.
- Use server_launcher.sh help to restart the relevant services.
Log Analysis:
- Check the detailed logs in the logs/ directory to locate the problem.
- Use log_manager.py report to generate an error report.
Plugin Debugging:
- Enable developer mode in Rhino and check the plugin loading status.
- Ensure that all API calls are correct.

🔧 Technical Details

The project uses a unified logging framework to record server, plugin, AI workstation, and diagnostic logs. All logs are stored in the logs/ directory by component and follow a consistent format. Log viewing, analysis, and report generation can be achieved through log_manager.py.