reer-rhino-mcp
Advanced tools
Supply Chain Security
Vulnerability
Quality
Maintenance
License
This project is developed by REER, INC. and made public for the community to use and test. We welcome contributors to help improve and expand the functionality of RhinoMCP. RhinoMCP connects Rhino, Grasshopper and more to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Rhino. This integration enables prompt-assisted 3D modeling, scene creation, and manipulation. (inspired by blender_mcp)
The project provides two server implementations:
Important Note: While Grasshopper integration tools may appear available in Claude, they are still under active development and not fully usable yet. We're working to implement complete Grasshopper functionality in future releases.
The system consists of two main components:
rhino_script.py): A Python script that runs inside Rhino to create a socket server that receives and executes commandsrhino_mcp/server.py): A Python server that implements the Model Context Protocol and connects to the Rhino scriptIf you're on Mac, open terminal and run:
brew install uv
On Windows open Powershell and run
irm https://astral.sh/uv/install.ps1 | iex
and then
set Path=C:\Users\<your_username>\.local\bin;%Path% # cmd
$env:Path = "C:\Users\<your_username>\.local\bin;";$env:Path # powershell
Otherwise installation instructions are on their website: Install uv
⚠️ Do not proceed before installing UV
First, you need to integrate with Claude Desktop:
claude_desktop_config.json file and add the following configuration:{
"mcpServers": {
"rhino": {
"command": "uvx",
"args": ["reer-rhino-mcp"]
}
}
}
Or if you want to use Cursor: For Mac users, go to Settings > MCP and paste the following
.cursor/mcp.json in the root of the project and paste{
"mcpServers": {
"rhino": {
"command": "uvx",
"args": [
"reer-rhino-mcp"
]
}
}
}
For Windows users, go to Settings > MCP > Add Server, add a new server with the following settings:
{
"mcpServers": {
"rhino": {
"command": "cmd",
"args": [
"/c",
"uvx",
"reer-rhino-mcp"
]
}
}
}
Note: If the single "uvx" command is not working, you can try specifying the full path to the uvx executable, it should be in your .local/bin folder if installed default:
"command": "/Users/<your_username>/.local/bin/uvx"
Then install the Rhino-side Script:
Download the rhino_script.py file from the repository
Open Rhino
For Rhino 7:
rhino_script.pyFor Rhino 8:
rhino_script.pyThe script will start automatically and you should see these messages in the Python Editor:
RhinoMCP script loaded. Server started automatically.
To stop the server, run: stop_server()
Lastly, restart the Claude Desktop, it will automatically start the MCP server and connect to Rhino
This method is recommended for most users who just want to use RhinoMCP without modifying its source code.
You can also watch the video tutorial for this method:
If you want to modify the source code or contribute to the project, you can install it in development mode:
Clone the repository
Create a new conda environment with Python 3.10:
conda create -n rhino_mcp python=3.10
conda activate rhino_mcp
Install the uv package manager:
pip install uv
Install the package in development mode:
uv pip install -e .
If you already have Python installed, you can install the MCP server directly to your base environment:
Install the package in development mode:
pip install -e .
Note that for Claude Desktop configuration, you'll need to find the correct system path to your Python installation. You can find this by running:
which python # On macOS/Linux
where python # On Windows
Same as Option 1, but you need to specify the full path to the Python interpreter in the claude_desktop_config.json file:
{
"mcpServers": {
"rhino": {
"command": "/your/python/path",
"args": ["-m", "rhino_mcp.server"]
}
}
}
Example Python paths:
C:\\Users\\username\\anaconda3\\envs\\rhino_mcp\\python.exe/Users/username/anaconda3/envs/rhino_mcp/bin/pythonMake sure to:
Important Note: If you're using a conda environment, you must specify the full path to the Python interpreter as shown above.
The SSE server is an alternative implementation of the Rhino MCP server that uses Server-Side Events for real-time communication. This server runs on 127.0.0.1:8080 and is designed to work with custom web clients. It provides the same functionality as the standard MCP server but uses a different transport protocol that's more suitable for web-based applications.
To use the SSE server:
python -m rhino_mcp.server_ssews://127.0.0.1:8080/ssehttp://127.0.0.1:8080/messages/The SSE server supports all the same Rhino operations as the standard MCP server, making it ideal for building custom web interfaces for Rhino control.
Once connected, Claude or another LLM can use the following MCP tools:
get_rhino_scene_info(): Get simplified scene information focusing on layers and example objectsget_rhino_layers(): Get information about all layers in the Rhino sceneexecute_code(code): Execute arbitrary Python code in Rhinoget_rhino_objects_with_metadata(filters, metadata_fields): Get detailed information about objects in the scene with their metadata, with optional filteringcapture_rhino_viewport(layer, show_annotations, max_size): Capture the viewport with optional annotations and layer filteringget_rhino_selected_objects(include_lights, include_grips): Get information about objects currently selected in the Rhino viewportlook_up_RhinoScriptSyntax(function_name): Look up documentation for a RhinoScriptSyntax function directly from the Rhino3D developer websiteHere are some examples of what you can ask Claude to do:
We welcome contributions to the RhinoMCP project! If you're interested in helping, here are some ways to contribute:
Please ensure your code follows the existing style and includes appropriate documentation.
This software is provided "as is", without warranty of any kind, express or implied. REER, INC. makes no warranties, representations or guarantees with respect to the software, including but not limited to quality, reliability, compatibility, or fitness for a particular purpose.
By using this software, you acknowledge and agree that REER, INC. shall not be liable for any direct, indirect, incidental, special, or consequential damages arising out of the use or inability to use the software.
This project is in active development and may contain bugs or incomplete features. While we strive for quality and reliability, please use appropriate caution when implementing in production environments.
FAQs
Rhino MCP Server
We found that reer-rhino-mcp demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
OWASP’s 2025 Top 10 introduces Software Supply Chain Failures as a new category, reflecting rising concern over dependency and build system risks.
Research
/Security News
Socket researchers discovered nine malicious NuGet packages that use time-delayed payloads to crash applications and corrupt industrial control systems.
Security News
Socket CTO Ahmad Nassri discusses why supply chain attacks now target developer machines and what AI means for the future of enterprise security.