Skip to main content
Glama
Pyramid Solver MCP

Pyramid Solver MCP

Pyramid Solver MCP

CI Deploy to Render

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

open_pyramid_solver

Öffnet den leeren interaktiven Solver.

solve_pyramid

Löst 16 Kachelpositionen, die Zeile für Zeile angegeben werden. Nutze 0 für das leere Feld.

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      4
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables users to load and solve Boxoban puzzles by providing tools to get game state, list valid moves, and take actions.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Standalone browser automation MCP server supporting both BrowserOS and standard Chrome. Enables 16 MCP tools for browser control including navigation, interaction, and content extraction.
      MIT