rubiks-cube-mcp
Exposes a Rubik's cube to an AI agent, allowing it to manipulate and solve the cube, with a web dashboard for monitoring agent runs.
README
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)
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.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.