Rubik's Cube

Rubik's Cube solver and visualization server for MCP. Features 3D cube rendering, real-time move tracking, and AI-driven solving.

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "fritzprix-rubiks-cube-mcp-server": {
      "command": "npx",
      "args": [
        "rubiks-cube-mcp-server"
      ]
    }
  }
}

You can run an MCP server that lets AI agents start, manipulate, and finish Rubik’s Cube solving sessions with live 3D visualization. It provides real-time updates, move histories, and interactive UI components so you can explore cube states and strategies seamlessly.

How to use

Start a new Rubik’s Cube session with the startCube tool to generate a game ID, scramble options, and an initial cube state. Use joinGame to participate in an existing session by providing its game ID. With manipulateCube, submit moves using standard cube notation (for example, U, D, L, R, F, B and their variants) to progress toward a solved cube. When the puzzle is solved, call finish to finalize the session and obtain final statistics and the move history. Throughout the process, you can view a real-time 3D visualization, move counters, and next action guidance to drive autonomous solving workflows.

How to install

Prerequisites: Install Node.js version 18.x or higher and a package manager (npm or yarn). Install dependencies, build the project, and run the server.

npm install
npm run build
npx rubiks-cube-mcp-server

Additional notes

The server exposes a runtime MCP UI for clickable game links and supports joining other users’ sessions. It includes a 3D visualization powered by Three.js and real-time synchronization via a WebSocket server. You can interact with the cube using the mouse to rotate and inspect faces, and the system tracks complete move history and cube state.

Configuration and runtime details

To integrate with Claude Desktop, add the MCP server configuration so Claude can launch and connect to the server. Use the following JSON snippet to define the server, which runs via npx and loads the Rubik’s Cube MCP server package.

{
  "mcpServers": {
    "rubiks-cube": {
      "command": "npx",
      "args": ["rubiks-cube-mcp-server"]
    }
  }
}

Available tools

startCube

Initialize a new Rubik's Cube game session with optional scramble and difficulty settings. Returns a UI resource, a session ID, and the initial cube state.

joinGame

Join an existing Rubik's Cube game session using its session ID. Returns the current cube state and session metadata.

manipulateCube

Execute a cube move using standard notation (U, D, L, R, F, B, and their variants). Returns the updated cube state and guidance for the next action.

finish

Complete the Rubik's Cube game session. Returns final statistics, move history, and completion status.