rubiks-cube-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
rubiks-cube-mcp
An MCP server that exposes a Rubik's cube to an agent, plus a small dashboard to watch agent runs in the browser.
Quickstart
uv sync
make build-web
make serve # dashboard at http://localhost:8000
make mcp # MCP server (stdio)Related MCP server: Chess MCP Server
Layout
Five uv workspace packages under packages/: cube, observe, mcp_server,
harness (stub), dashboard. See docs/architecture/LAYOUT.md for the
single source of truth and docs/design/mvp.md for the framing.
Run logs live in $XDG_DATA_HOME/rubiks-cube-mcp/
(default ~/.local/share/rubiks-cube-mcp/), never in the repo.
A note on the solver
The solve_hint tool wraps kociemba,
which ships an x86_64 C extension. On machines where that wheel doesn't load
(notably arm64 macOS without a matching wheel), kociemba transparently falls
back to a pure-Python implementation of the same algorithm. We use that
fallback path by default — it works on every architecture with no build step
and solves in ~1 second.
Want the native C extension speed? Run make solver-fast once. That
rebuilds kociemba from source against your local architecture (sub-millisecond
solves afterward). Requires a C compiler on your PATH — on macOS install
with xcode-select --install; on Linux apt install build-essential; on
Windows install MSVC build tools. Purely opt-in; nothing else needs to change
in our code, our wrapper picks up the C extension automatically when it loads.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Human-in-the-loop control panel for AI agents: start runs, review them, answer their requests.
Build, validate, and deploy multi-agent AI solutions from any AI environment.
Control a real browser from AI agents: navigate, click, type, screenshot, read the page.
Web infrastructure for AI agents: scrape, crawl and search the web, run browsers and agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI agents to solve Rubik's Cube puzzles through systematic manipulation with standard cube notation moves. Features real-time 3D visualization and interactive controls for tracking solving progress.423 npmMIT
- AlicenseAqualityBmaintenanceEnables Large Language Models to play chess agentically with real-time HTML board visualization and a hybrid AI engine featuring ten difficulty levels. It supports interactive games between users and agents, including a web dashboard to monitor active matches.497 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceEnables real-time communication and orchestration of multiple AI agents with a web dashboard for monitoring agent activities, tasks, and artifacts.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to interact with a running Roblox game client, including executing Lua code, inspecting scripts, and spying on remotes, with a local dashboard for monitoring and control.66 npmMIT