Pyramid Solver MCP
Pyramid Solver MCP
Интерактивный решатель головоломки «4×4 скользящие плитки». Работает в двух режимах:
как MCP-приложение, отображаемое внутри ChatGPT;
как обычное браузерное приложение в корне сервера.
В проекте используются React для виджета, официальный Model Context Protocol SDK для сервера и автономная сборка Vite, которую можно возвращать как ресурс пользовательского интерфейса MCP.
Инструменты MCP
Инструмент | Что делает |
| Открывает пустой интерактивный решатель. |
| Решает 16 позиций плиток, указанных построчно. Используйте |
Решатель предлагает быстрый режим 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:
Войдите в Render и разрешите доступ к этому репозиторию GitHub.
Оставьте настройки Blueprint и выберите Deploy Blueprint.
Дождитесь, пока сервис станет Live.
Скопируйте сгенерированный URL, например
https://pyramid-solver-mcp.onrender.com.Убедитесь, что
<your-url>/healthвозвращает{"ok":true}.
Включенный render.yaml собирает Dockerfile, проверяет /health и развертывает изменения только после прохождения CI в GitHub. Бесплатный сервис Render может отвечать дольше после простоя.
Подключение к ChatGPT
ChatGPT требует публичную HTTPS-конечную точку MCP. После развертывания:
В ChatGPT откройте Настройки → Безопасность и вход → Режим разработчика и включите его.
Откройте Плагины и нажмите кнопку +.
Введите название, например
Pyramid Solver, и краткое описание.Установите конечную точку на ваш полный URL Render, заканчивающийся на
/mcp, напримерhttps://pyramid-solver-mcp.onrender.com/mcp.Проверьте обнаруженные инструменты и завершите добавление плагина.
Если определения инструментов изменятся после последующего развертывания, обновите плагин, чтобы 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
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.-