Pyramid Solver MCP
Pyramid Solver MCP
Ein interaktiver Solver für das 4×4-Schiebepuzzle. Er funktioniert in zwei Modi:
als MCP App, die in ChatGPT gerendert wird;
als normale Browser-App unter der Server-Root.
Das Projekt verwendet React für das Widget, das offizielle Model Context Protocol SDK für den Server und einen eigenständigen Vite-Build, der als MCP-UI-Ressource zurückgegeben werden kann.
MCP-Tools
Tool | Was es tut |
| Öffnet den leeren interaktiven Solver. |
| Löst 16 Kachelpositionen, die Zeile für Zeile angegeben werden. Nutze |
Der Solver bietet schnelle Weighted-A*- und optimale IDA*-Modi.
Related MCP server: boxoban-mcp
Lokal ausführen
Voraussetzungen: Node.js 20 oder neuer.
npm install
npm run build
npm startÖffne http://localhost:8787 für den Browsermodus. Der MCP-Endpunkt für Streamable HTTP lautet:
http://localhost:8787/mcpTest
npm test
npm run build
npm run smokeDu kannst den MCP-Server mit folgendem Befehl überprüfen:
npx @modelcontextprotocol/inspector@latestWähle Streamable HTTP und verbinde dich mit http://localhost:8787/mcp.
Auf eine öffentliche URL bereitstellen
Der schnellste Weg ist die Schaltfläche Deploy to Render oben in dieser README:
Melde dich bei Render an und erlaube ihm den Zugriff auf dieses GitHub-Repository.
Behalte die Blueprint-Einstellungen bei und wähle Deploy Blueprint.
Warte, bis der Dienst den Status Live erreicht.
Kopiere die generierte URL, z. B.
https://pyramid-solver-mcp.onrender.com.Prüfe, dass
<your-url>/health{"ok":true}zurückgibt.
Die enthaltene render.yaml baut das Dockerfile, prüft /health und stellt Änderungen erst nach bestandener GitHub-CI bereit. Renders kostenloser Dienst kann nach einer Phase der Inaktivität länger brauchen, um zu antworten.
Mit ChatGPT verbinden
ChatGPT benötigt einen öffentlichen HTTPS-MCP-Endpunkt. Nach dem Deployment:
Öffne in ChatGPT Einstellungen → Sicherheit und Anmeldung → Entwicklermodus und aktiviere ihn.
Öffne Plugins und klicke auf die Schaltfläche +.
Gib einen Namen wie
Pyramid Solverund eine kurze Beschreibung ein.Setze den Endpunkt auf deine vollständige Render-URL, die auf
/mcpendet, zum Beispielhttps://pyramid-solver-mcp.onrender.com/mcp.Überprüfe die erkannten Tools und schließe das Hinzufügen des Plugins ab.
Falls sich die Tool-Definitionen nach einem späteren Deployment ändern, aktualisiere das Plugin, damit ChatGPT die neuen Metadaten lädt. Siehe die OpenAI-Anleitung Verbinde deinen MCP-Server mit ChatGPT für die aktuelle Oberfläche.
Sobald die Verbindung steht, versuche es mit Open the Pyramid Solver oder gib ein Spielbrett wie folgt an:
1 2 3 4
5 6 7 8
9 10 11 12
13 14 0 15Nützliche Tests:
Open the Pyramid Solver.Solve this board with A*: 1 2 3 4 / 5 6 7 8 / 9 10 11 12 / 13 14 0 15.Solve this board optimally with IDA*: 1 2 3 4 / 5 6 7 8 / 9 10 11 12 / 13 14 0 15.
Docker
docker build -t pyramid-solver-mcp .
docker run --rm -p 8787:8787 pyramid-solver-mcpProjektstruktur
src/PyramidSolver.jsx React interface
src/solver.js A* and IDA* solver engine
src/mcpBridge.js MCP Apps UI bridge
server.js Streamable HTTP MCP server
test/solver.test.js Solver testsLizenz
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Daily puzzle arena for AI agents over MCP, ranked by step-efficiency on a public leaderboard.
Number puzzle API + MCP: solver-checked puzzles as JSON/SVG, daily puzzle. $5/mo; 50 free/day.
20 MCP tools + 17 widgets for SAT/ISEE/SSAT/GRE/GMAT/LSAT prep. Flashcards, quizzes & games. Hosted.
Deterministic Sudoku puzzles, progress checks, logical hints, and step-by-step solutions.
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.4MIT
- FlicenseNot gradedqualityDmaintenanceEnables users to load and solve Boxoban puzzles by providing tools to get game state, list valid moves, and take actions.-
- AlicenseNot gradedqualityDmaintenanceStandalone browser automation MCP server supporting both BrowserOS and standard Chrome. Enables 16 MCP tools for browser control including navigation, interaction, and content extraction.MIT
- FlicenseNot gradedqualityDmaintenanceEnables browser automation with AI agent support and secure credential management through 20 MCP tools, accessible via stdio or HTTP bridge.-