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

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/mcp

Test

npm test
npm run build
npm run smoke

Du kannst den MCP-Server mit folgendem Befehl überprüfen:

npx @modelcontextprotocol/inspector@latest

Wä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:

1. Melde dich bei Render an und erlaube ihm den Zugriff auf dieses GitHub-Repository.

2. Behalte die Blueprint-Einstellungen bei und wähle Deploy Blueprint.

3. Warte, bis der Dienst den Status Live erreicht.

4. Kopiere die generierte URL, z. B. https://pyramid-solver-mcp.onrender.com.

5. 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:

1. Öffne in ChatGPT Einstellungen → Sicherheit und Anmeldung → Entwicklermodus und aktiviere ihn.

2. Öffne Plugins und klicke auf die Schaltfläche +.

3. Gib einen Namen wie Pyramid Solver und eine kurze Beschreibung ein.

4. Setze den Endpunkt auf deine vollständige Render-URL, die auf /mcp endet, zum Beispiel https://pyramid-solver-mcp.onrender.com/mcp.

5. Ü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 15

Nü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-mcp

Projektstruktur

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 tests

Lizenz

MIT