Pyramid Solver MCP

Un solucionador interactivo para el puzle deslizante de 4×4. Funciona en dos modos:

• como una MCP App renderizada dentro de ChatGPT;

• como una aplicación de navegador normal en la raíz del servidor.

El proyecto utiliza React para el widget, el SDK oficial de Model Context Protocol para el servidor y una compilación de Vite autocontenida que se puede devolver como un recurso de UI de MCP.

Herramientas de MCP

El solucionador ofrece modos rápidos de A* ponderado e IDA* óptimo.

Related MCP server: boxoban-mcp

Ejecutar localmente

Requisitos: Node.js 20 o superior.

npm install
npm run build
npm start

Abre http://localhost:8787 para el modo navegador. El endpoint MCP de Streamable HTTP es:

http://localhost:8787/mcp

Pruebas

npm test
npm run build
npm run smoke

Puedes inspeccionar el servidor MCP con:

npx @modelcontextprotocol/inspector@latest

Elige Streamable HTTP y conéctate a http://localhost:8787/mcp.

Desplegar en una URL pública

La vía más rápida es el botón Deploy to Render al principio de este README:

1. Inicia sesión en Render y permítele acceder a este repositorio de GitHub.

2. Mantén la configuración de Blueprint y elige Deploy Blueprint.

3. Espera a que el servicio pase a Live.

4. Copia la URL generada, como https://pyramid-solver-mcp.onrender.com.

5. Comprueba que <your-url>/health devuelve {"ok":true}.

El render.yaml incluido construye el Dockerfile, comprueba /health y despliega los cambios solo después de que pase la CI de GitHub. El servicio gratuito de Render puede tardar más en responder después de estar inactivo.

Conectarlo a ChatGPT

ChatGPT requiere un endpoint MCP HTTPS público. Después del despliegue:

1. En ChatGPT, abre Configuración → Seguridad e inicio de sesión → Modo desarrollador y actívalo.

2. Abre Plugins y selecciona el botón +.

3. Introduce un nombre como Pyramid Solver y una breve descripción.

4. Establece el endpoint en tu URL completa de Render que termine en /mcp, por ejemplo https://pyramid-solver-mcp.onrender.com/mcp.

5. Revisa las herramientas descubiertas y termina de añadir el plugin.

Si las definiciones de las herramientas cambian después de un despliegue posterior, actualiza el plugin para que ChatGPT cargue los nuevos metadatos. Consulta la guía de OpenAI Conecta tu servidor MCP a ChatGPT para conocer la interfaz actual.

Una vez conectado, prueba Open the Pyramid Solver o proporciona un tablero como:

1 2 3 4
5 6 7 8
9 10 11 12
13 14 0 15

Comprobaciones útiles:

• 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

Estructura del proyecto

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

Licencia

MIT