plugins, or MCP integration, please consider contributing. Contact us by opening an issue on GitHub.

Skip to content

You signed in with another tab or window. Reload
to refresh your session. You signed out in another tab or window. Reload
to refresh your session. You switched accounts on another tab or window. Reload
to refresh your session. Dismiss alert

always-tinkering / rhinoMcpServer Public

• Notifications
  You must be signed in to change notification settings

• Fork 1

• Star 16

RhinoMCP connects Rhino to Claude AI through the Model Context Protocol (MCP), enabling AI-assisted 3D modeling and architectural design.

16 stars
1 fork
Branches
Tags
Activity

Star

Notifications
You must be signed in to change notification settings

always-tinkering/rhinoMcpServer

main

1 Branch
0 Tags

Go to file

Code

Folders and files

| Name | | Name | Last commit message | Last commit date |
| --- | --- | --- | --- |
| Latest commit
-------------


elemental-Andrew

Implement GetSceneContext tests for RhinoUtilities to validate scene …

Mar 23, 2025

67e8896
 · Mar 23, 2025

History
-------

35 Commits

| | |
| RhinoMcpPlugin.Tests | | RhinoMcpPlugin.Tests | Implement GetSceneContext tests for RhinoUtilities to validate scene … | Mar 23, 2025 |
| RhinoMcpPlugin | | RhinoMcpPlugin | Clean repository for smaller push | Mar 15, 2025 |
| logs | | logs | Update .gitignore and remove log files from tracking | Mar 17, 2025 |
| scripts | | scripts | Add unified logging system with centralized log management and improv… | Mar 17, 2025 |
| src | | src | Add unified logging system with centralized log management and improv… | Mar 17, 2025 |
| .gitignore | | .gitignore | Update .gitignore and remove log files from tracking | Mar 17, 2025 |
| LOGGING.md | | LOGGING.md | Add unified logging system with centralized log management and improv… | Mar 17, 2025 |
| NLog.config | | NLog.config | Add Rhino plugin improvements with enhanced logging and null referenc… | Mar 17, 2025 |
| README.md | | README.md | Add system architecture diagram and documentation | Mar 21, 2025 |
| RHINO_PLUGIN_UPDATE.md | | RHINO_PLUGIN_UPDATE.md | Add Rhino plugin improvements with enhanced logging and null referenc… | Mar 17, 2025 |
| RhinoPluginFixImplementation.cs | | RhinoPluginFixImplementation.cs | Add Rhino plugin improvements with enhanced logging and null referenc… | Mar 17, 2025 |
| RhinoPluginLoggingSpec.md | | RhinoPluginLoggingSpec.md | Add Rhino plugin improvements with enhanced logging and null referenc… | Mar 17, 2025 |
| code_architecture.md | | code_architecture.md | Add system architecture diagram and documentation | Mar 21, 2025 |
| combined_mcp_server.py | | combined_mcp_server.py | Add unified logging system with centralized log management and improv… | Mar 17, 2025 |
| diagnose_rhino_connection.py | | diagnose_rhino_connection.py | Add unified logging system with centralized log management and improv… | Mar 17, 2025 |
| log_manager.py | | log_manager.py | Add unified logging system with centralized log management and improv… | Mar 17, 2025 |
| mcpLLM.txt | | mcpLLM.txt | Implemented robust file-based logging system | Mar 15, 2025 |
| run-combined-server.sh | | run-combined-server.sh | Add unified logging system with centralized log management and improv… | Mar 17, 2025 |
| View all files | | |

Repository files navigation

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:

Loading

graph TD
%% Client Applications
client[Client Applications] --> socketProxy

%% Socket Proxy
subgraph "Python Socket Proxy"
    socketProxy\[socket\_proxy.py\] --> daemonServer
end

%% Daemon Server
subgraph "Python Daemon Server"
    daemonServer\[daemon\_mcp\_server.py\] --> combinedServer
end

%% Combined MCP Server
subgraph "Python Combined MCP Server"
    combinedServer\[combined\_mcp\_server.py\]
    mcp\[FastMCP\] --> tools
    combinedServer --> mcp
    combinedServer --> rhinoConn
    subgraph "MCP Tools"
        tools\[MCP Tool Methods\]
    end
    rhinoConn\[RhinoConnection\]
end

%% Rhino Plugin Components
subgraph "C# Rhino Plugin"
    rhinoPlugin\[RhinoMcpPlugin.cs\]
    socketServer\[RhinoSocketServer.cs\]
    utilities\[RhinoUtilities.cs\]
    commands\[RhinoMcpCommand.cs\]

    rhinoPlugin --> socketServer
    rhinoPlugin --> commands
    socketServer --> utilities
end

%% Connections between components
rhinoConn <==> socketServer

%% Logger Components
subgraph "Logging System"
    logManager\[log\_manager.py\]
    nlogConfig\[NLog.config\]
end

combinedServer --> logManager
rhinoPlugin --> nlogConfig

%% Connection to Rhino
rhino\[Rhino 3D Software\]
rhinoPlugin --> rhino

classDef pythonClass fill:#3572A5,color:white;
classDef csharpClass fill:#178600,color:white;
classDef rhinoClass fill:#555555,color:white;

class socketProxy,daemonServer,combinedServer,mcp,tools,rhinoConn,logManager pythonClass;
class rhinoPlugin,socketServer,utilities,commands csharpClass;
class rhino rhinoClass;

For more detailed information about the system architecture, including component descriptions and data flow, see code_architecture.md
.

Components

There are several implementations available:

1. Combined MCP Server (Recommended):

   • combined_mcp_server.py - Direct implementation that uses stdin/stdout for communication

   • Socket-based Servers:

   • daemon_mcp_server.py - Background server that receives commands via socket connection

   • socket_proxy.py - Proxy that forwards commands from stdin to the daemon server and back

   • Standalone Server:

   • standalone-mcp-server.py - Original standalone implementation

Setup Instructions

1. Set up Claude Desktop

1. Install Claude Desktop if you haven't already
2. 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:

./server_launcher.sh [mode]

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:

# Run the combined server (recommended)
./server_launcher.sh combined

# Or simply
./server_launcher.sh

# Run the socket-based approach (daemon + proxy)
./server_launcher.sh direct

# Monitor logs in real-time
./server_launcher.sh monitor

Available Tools

The server provides several tools for 3D modeling:

1. geometry_tools.create_sphere - Create a sphere with specified center and radius
2. geometry_tools.create_box - Create a box with specified dimensions
3. geometry_tools.create_cylinder - Create a cylinder with specified parameters
4. scene_tools.get_scene_info - Get information about the current scene
5. scene_tools.clear_scene - Clear objects from the scene
6. scene_tools.create_layer - Create a new layer in the document

Troubleshooting

If you encounter connection issues:

1. Make sure no old servers are running:

   shell ./server_launcher.sh help # This will clean up existing processes

2. Check the log files:

   shell ./server_launcher.sh logs # View logs ./server_launcher.sh errors # View errors

3. 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:

# View logs
./server_launcher.sh logs

# Monitor logs in real-time
./server_launcher.sh monitor

# View errors with context
./server_launcher.sh errors

# Generate error reports (using the log manager directly)
./log_manager.py report

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

1. Add new tools as methods in the combined_mcp_server.py file
2. Use the existing logging framework for consistent error handling
3. Update diagnostic tools if needed

About

RhinoMCP connects Rhino to Claude AI through the Model Context Protocol (MCP), enabling AI-assisted 3D modeling and architectural design.

Resources

Readme

Activity

Stars

16 stars

Watchers

2 watching

Forks

1 fork

Report repository

Releases

No releases published

Packages 0

No packages published

Languages

• C# 51.3%

• Python 45.4%

• Shell 3.3%

You can’t perform that action at this time.