Rhino MCP Server
** UNDER CONSTRUCTION **This project is currently under active development and is not yet in working order. The Rhino plugin is experiencing issues with creating objects. We are actively seeking support from the community to help resolve these issues. If you have experience with Rhino API development, C# plugins, or MCP integration, please consider contributing. Contact us by opening an issue on GitHub.
A Model Context Protocol (MCP) server implementation for Rhino 3D, allowing Claude to create and manipulate 3D objects.
Overview
This project implements an MCP server for Rhino 3D that enables AI assistants like Claude to interact with Rhino through the Model Context Protocol. The server allows for the creation and manipulation of 3D objects directly from the AI interface.
System Architecture
The system consists of Python components that implement the MCP server and C# components that integrate with Rhino. Here's an overview of how the system components interact:
For more detailed information about the system architecture, including component descriptions and data flow, see code_architecture.md.
Components
There are several implementations available:
- Combined MCP Server (Recommended):
- Socket-based Servers:
- Standalone Server:
Setup Instructions
1. Set up Claude Desktop
- Install Claude Desktop if you haven't already
- Configure the MCP server connection in Claude Desktop settings
2. Run the Server
We now have a unified server launcher that allows you to run any of the server implementations:
Available modes:
combined(default) - Run the combined MCP server
standalone- Run the standalone MCP server
daemon- Run the daemon MCP server
socket-proxy- Run the socket proxy
direct- Run both daemon and socket proxy
logs- View recent logs
monitor- Monitor logs in real-time
errors- View recent errors
help- Show help message
Examples:
Available Tools
The server provides several tools for 3D modeling:
- geometry_tools.create_sphere - Create a sphere with specified center and radius
- geometry_tools.create_box - Create a box 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 objects from the scene
- scene_tools.create_layer - Create a new layer in the document
Troubleshooting
If you encounter connection issues:
- Make sure no old servers are running:
- Check the log files:
- Restart Claude Desktop completely
License
This project is released under the MIT License. See the LICENSE file for details.
Improved Logging System
The system features a unified logging framework that centralizes logs from all components:
- Server logs
- Plugin logs
- Claude AI logs
- Diagnostic logs
All logs follow a consistent format and are stored in the
logs/ directory with separate subdirectories for each component.Log Management
A log management tool is provided that offers powerful capabilities for viewing, monitoring, and analyzing logs:
For detailed information on using the logging system, see LOGGING.md.
Development
Project Structure
combined_mcp_server.py: Main MCP server implementation
diagnose_rhino_connection.py: Diagnostic tool for testing Rhino connection
log_manager.py: Tool for managing and analyzing logs
server_launcher.sh: Unified script to start any server implementation
logs/: Directory containing all logs
Adding New Features
- Add new tools as methods in the
combined_mcp_server.pyfile
- Use the existing logging framework for consistent error handling
- Update diagnostic tools if needed
Rhino MCP Server
** UNDER CONSTRUCTION **This project is currently under active development and is not yet in working order. The Rhino plugin is experiencing issues with creating objects. We are actively seeking support from the community to help resolve these issues. If you have experience with Rhino API development, C# plugins, or MCP integration, please consider contributing. Contact us by opening an issue on GitHub.
A Model Context Protocol (MCP) server implementation for Rhino 3D, allowing Claude to create and manipulate 3D objects.
Overview
This project implements an MCP server for Rhino 3D that enables AI assistants like Claude to interact with Rhino through the Model Context Protocol. The server allows for the creation and manipulation of 3D objects directly from the AI interface.
System Architecture
The system consists of Python components that implement the MCP server and C# components that integrate with Rhino. Here's an overview of how the system components interact:
For more detailed information about the system architecture, including component descriptions and data flow, see code_architecture.md.
Components
There are several implementations available:
- Combined MCP Server (Recommended):
- Socket-based Servers:
- Standalone Server:
Setup Instructions
1. Set up Claude Desktop
- Install Claude Desktop if you haven't already
- Configure the MCP server connection in Claude Desktop settings
2. Run the Server
We now have a unified server launcher that allows you to run any of the server implementations:
Available modes:
combined(default) - Run the combined MCP server
standalone- Run the standalone MCP server
daemon- Run the daemon MCP server
socket-proxy- Run the socket proxy
direct- Run both daemon and socket proxy
logs- View recent logs
monitor- Monitor logs in real-time
errors- View recent errors
help- Show help message
Examples:
Available Tools
The server provides several tools for 3D modeling:
- geometry_tools.create_sphere - Create a sphere with specified center and radius
- geometry_tools.create_box - Create a box 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 objects from the scene
- scene_tools.create_layer - Create a new layer in the document
Troubleshooting
If you encounter connection issues:
- Make sure no old servers are running:
- Check the log files:
- Restart Claude Desktop completely
License
This project is released under the MIT License. See the LICENSE file for details.
Improved Logging System
The system features a unified logging framework that centralizes logs from all components:
- Server logs
- Plugin logs
- Claude AI logs
- Diagnostic logs
All logs follow a consistent format and are stored in the
logs/ directory with separate subdirectories for each component.Log Management
A log management tool is provided that offers powerful capabilities for viewing, monitoring, and analyzing logs:
For detailed information on using the logging system, see LOGGING.md.
Development
Project Structure
combined_mcp_server.py: Main MCP server implementation
diagnose_rhino_connection.py: Diagnostic tool for testing Rhino connection
log_manager.py: Tool for managing and analyzing logs
server_launcher.sh: Unified script to start any server implementation
logs/: Directory containing all logs
Adding New Features
- Add new tools as methods in the
combined_mcp_server.pyfile
- Use the existing logging framework for consistent error handling
- Update diagnostic tools if needed