Pyramid Solver MCP
Pyramid Solver MCP
4×4 슬라이딩 퍼즐용 인터랙티브 솔버입니다. 두 가지 모드로 작동합니다:
ChatGPT 안에서 렌더링되는 MCP App으로;
서버 루트에서 일반 브라우저 앱으로.
이 프로젝트는 위젯에는 React, 서버에는 공식 Model Context Protocol SDK, 그리고 MCP UI 리소스로 반환할 수 있는 자체 포함형 Vite 빌드를 사용합니다.
MCP 도구
도구 | 기능 |
| 빈 상태의 인터랙티브 솔버를 엽니다. |
| 행 단위로 입력된 16개 타일 위치를 풉니다. 빈 칸에는 |
솔버는 빠른 Weighted A* 모드와 최적 IDA* 모드를 제공합니다.
Related MCP server: boxoban-mcp
로컬에서 실행
요구 사항: Node.js 20 이상.
npm install
npm run build
npm start브라우저 모드에서는 http://localhost:8787을 여세요. Streamable HTTP MCP 엔드포인트는 다음과 같습니다:
http://localhost:8787/mcp테스트
npm test
npm run build
npm run smokeMCP 서버는 다음과 같이 검사할 수 있습니다:
npx @modelcontextprotocol/inspector@latestStreamable HTTP를 선택하고 http://localhost:8787/mcp에 연결하세요.
공개 URL에 배포
가장 빠른 방법은 이 README 상단의 Deploy to Render 버튼을 사용하는 것입니다:
Render에 로그인하고 이 GitHub 저장소에 접근할 수 있도록 허용하세요.
Blueprint 설정을 유지하고 Deploy Blueprint를 선택하세요.
서비스가 Live 상태가 될 때까지 기다리세요.
생성된 URL(예:
https://pyramid-solver-mcp.onrender.com)을 복사하세요.<your-url>/health가{"ok":true}를 반환하는지 확인하세요.
포함된 render.yaml은 Dockerfile을 빌드하고 /health를 확인하며, GitHub CI가 통과한 후에만 변경 사항을 배포합니다. Render의 무료 서비스는 유휴 상태 후 응답하는 데 더 오래 걸릴 수 있습니다.
ChatGPT에 연결
ChatGPT에는 공개 HTTPS MCP 엔드포인트가 필요합니다. 배포 후:
ChatGPT에서 Settings → Security and login → Developer mode를 열고 활성화하세요.
Plugins를 열고 + 버튼을 선택하세요.
Pyramid Solver와 같은 이름과 짧은 설명을 입력하세요.엔드포인트를
/mcp로 끝나는 전체 Render URL로 설정하세요(예: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.-