Pyramid Solver MCP

4×4 슬라이딩 퍼즐용 인터랙티브 솔버입니다. 두 가지 모드로 작동합니다:

• ChatGPT 안에서 렌더링되는 MCP App으로;

• 서버 루트에서 일반 브라우저 앱으로.

이 프로젝트는 위젯에는 React, 서버에는 공식 Model Context Protocol SDK, 그리고 MCP UI 리소스로 반환할 수 있는 자체 포함형 Vite 빌드를 사용합니다.

MCP 도구

솔버는 빠른 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 smoke

MCP 서버는 다음과 같이 검사할 수 있습니다:

npx @modelcontextprotocol/inspector@latest

Streamable HTTP를 선택하고 http://localhost:8787/mcp에 연결하세요.

공개 URL에 배포

가장 빠른 방법은 이 README 상단의 Deploy to Render 버튼을 사용하는 것입니다:

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를 확인하며, GitHub CI가 통과한 후에만 변경 사항을 배포합니다. Render의 무료 서비스는 유휴 상태 후 응답하는 데 더 오래 걸릴 수 있습니다.

ChatGPT에 연결

ChatGPT에는 공개 HTTPS MCP 엔드포인트가 필요합니다. 배포 후:

1. ChatGPT에서 Settings → Security and login → Developer mode를 열고 활성화하세요.

2. Plugins를 열고 + 버튼을 선택하세요.

3. Pyramid Solver와 같은 이름과 짧은 설명을 입력하세요.

4. 엔드포인트를 /mcp로 끝나는 전체 Render URL로 설정하세요(예: 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