Skip to main content
Glama
Pyramid Solver MCP

Pyramid Solver MCP

Pyramid Solver MCP

CI Deploy to Render

Интерактивный решатель головоломки «4×4 скользящие плитки». Работает в двух режимах:

  • как MCP-приложение, отображаемое внутри ChatGPT;

  • как обычное браузерное приложение в корне сервера.

В проекте используются React для виджета, официальный Model Context Protocol SDK для сервера и автономная сборка Vite, которую можно возвращать как ресурс пользовательского интерфейса MCP.

Инструменты MCP

Инструмент

Что делает

open_pyramid_solver

Открывает пустой интерактивный решатель.

solve_pyramid

Решает 16 позиций плиток, указанных построчно. Используйте 0 для пустой ячейки.

Решатель предлагает быстрый режим Weighted A* и оптимальный режим IDA*.

Related MCP server: boxoban-mcp

Локальный запуск

Требования: Node.js 20 или новее.

npm install
npm run build
npm start

Откройте http://localhost:8787 для браузерного режима. Конечная точка MCP Streamable HTTP:

http://localhost:8787/mcp

Тестирование

npm test
npm run build
npm run smoke

Вы можете проверить MCP-сервер с помощью:

npx @modelcontextprotocol/inspector@latest

Выберите Streamable HTTP и подключитесь к http://localhost:8787/mcp.

Развертывание на публичный URL

Самый быстрый путь — кнопка Deploy to Render в верхней части этого README:

  1. Войдите в Render и разрешите доступ к этому репозиторию GitHub.

  2. Оставьте настройки Blueprint и выберите Deploy Blueprint.

  3. Дождитесь, пока сервис станет Live.

  4. Скопируйте сгенерированный URL, например https://pyramid-solver-mcp.onrender.com.

  5. Убедитесь, что <your-url>/health возвращает {"ok":true}.

Включенный render.yaml собирает Dockerfile, проверяет /health и развертывает изменения только после прохождения CI в GitHub. Бесплатный сервис Render может отвечать дольше после простоя.

Подключение к ChatGPT

ChatGPT требует публичную HTTPS-конечную точку MCP. После развертывания:

  1. В ChatGPT откройте Настройки → Безопасность и вход → Режим разработчика и включите его.

  2. Откройте Плагины и нажмите кнопку +.

  3. Введите название, например Pyramid Solver, и краткое описание.

  4. Установите конечную точку на ваш полный URL Render, заканчивающийся на /mcp, например https://pyramid-solver-mcp.onrender.com/mcp.

  5. Проверьте обнаруженные инструменты и завершите добавление плагина.

Если определения инструментов изменятся после последующего развертывания, обновите плагин, чтобы ChatGPT загрузил новые метаданные. Актуальный интерфейс описан в руководстве OpenAI Подключение вашего MCP-сервера к ChatGPT.

После подключения попробуйте команду Open the Pyramid Solver или укажите доску, например:

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

Полезные проверки:

  • 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

Структура проекта

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

Лицензия

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