Skip to content

commands.md

Latest commit

 

History

History
109 lines (81 loc) · 2.49 KB

commands.md

File metadata and controls

109 lines (81 loc) · 2.49 KB

Commands

rhino mcp

Start the Model Context Protocol server for Claude Desktop integration.

Description: The MCP server communicates via stdio (JSON-RPC) and connects to the Rhino HTTP server running on localhost:9090. It exposes tools and resources that allow Claude Desktop to control Rhino 3D.

Prerequisites:

  • Rhino HTTP server must be running: rhino server

Flags:

Example:

rhino mcp                              # Connect to localhost:9090
rhino mcp --server-url http://localhost:3000  # Custom server URL

Claude Desktop Configuration: Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "rhino": {
      "command": "/path/to/rhino",
      "args": ["mcp"]
    }
  }
}

See Claude Desktop Setup for detailed configuration instructions.

rhino ping

Check if the Rhino HTTP server is running and healthy.

Flags:

  • --timeout: Ping timeout (default: 2s)
  • --count, -c: Number of pings to send (default: 1)

Example:

rhino ping                    # Single ping
rhino ping --count 3          # Ping 3 times
rhino ping --timeout 5s       # Custom timeout

rhino server

Start the HTTP server and Rhino process.

Flags:

  • --port, -p: HTTP server port (default: 9090)
  • --host: HTTP server host (default: 127.0.0.1)
  • --rhino-mode: Rhino server binding mode: unix, tcp, both
  • --rhino-socket: Unix socket path
  • --rhino-tcp-host: TCP host for Rhino server
  • --rhino-tcp-port: TCP port for Rhino server

Example:

rhino server --port 9090 --host 0.0.0.0

rhino exec

Execute Python code in Rhino via the HTTP server.

Flags:

  • --code: Python code string to execute
  • --file: Python file to execute
  • --timeout: Execution timeout (default: 60s)

Example:

rhino exec --code "rs.AddPoint([0,0,0])"
rhino exec --file my_script.py --timeout 120s

rhino eval

Evaluate a Python expression and return its value.

Flags:

  • --expr, -e: Python expression to evaluate (required)
  • --timeout: Evaluation timeout (default: 30s)

Example:

rhino eval --expr "rs.UnitSystem()"
rhino eval -e "len(rs.AllObjects())"

rhino doctor

Check and fix Rhino configuration issues.

Flags:

  • --fix: Automatically fix issues

Example:

rhino doctor          # Check for issues
rhino doctor --fix    # Fix issues automatically