Pyramid Solver MCP

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

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

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

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

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

Решатель предлагает быстрый режим 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