pyxel-mcp

Python용 레트로 게임 엔진인 Pyxel을 위한 MCP 서버입니다. AI가 레트로 게임 프로그램을 자율적으로 실행, 검증 및 반복할 수 있도록 지원합니다.

기능

실행 및 캡처

• run_and_capture — Pyxel 스크립트를 실행하고 N 프레임 후 스크린샷을 캡처합니다.

• capture_frames — 애니메이션 검증을 위해 여러 프레임 지점에서 스크린샷을 캡처합니다.

• record_gameplay — 애니메이션/전환 검증을 위해 N 프레임을 GIF로 기록합니다.

• play_and_capture — 시뮬레이션된 입력을 보내 게임을 플레이하고 스크린샷을 캡처합니다.

검사 및 디버깅

• validate_script — Pyxel 스크립트를 실행하지 않고 유효성을 검사합니다.

• inspect_state — 디버깅을 위해 특정 프레임에서 게임 객체 속성을 읽습니다.

• inspect_screen — 화면을 압축된 색상 인덱스 그리드로 캡처합니다.

• compare_frames — 두 프레임의 스크린샷을 비교하고 픽셀 차이를 보고합니다.

시각적 분석

• inspect_sprite — Pyxel 이미지 뱅크에서 스프라이트 픽셀 데이터를 검사합니다.

• inspect_layout — 화면 레이아웃, 텍스트 정렬 및 시각적 균형을 분석합니다.

• inspect_palette — Pyxel 스크린샷의 색상 사용 및 대비를 분석합니다.

• inspect_bank — 전체 Pyxel 이미지 뱅크를 단일 스크린샷으로 시각화합니다.

• inspect_tilemap — 타일맵 콘텐츠, 타일 사용량 및 레이아웃을 검사합니다.

• inspect_animation — 애니메이션 프레임 전반에 걸쳐 스프라이트 시트 일관성을 확인합니다.

오디오

• render_audio — Pyxel 사운드나 음악을 WAV로 렌더링하고 파형 분석 결과를 반환합니다.

리소스 (Pyxel 참조)

도구 외에도 서버는 Pyxel 참조 콘텐츠를 MCP 리소스로 제공합니다:

• pyxel://api-reference, pyxel://user-guide, pyxel://mml-commands, pyxel://pyxres-format — 공식 Pyxel 문서

• pyxel://examples/<name> — 공식 Pyxel 예제 (예: 02_jump_game)

• pyxel://palette/default — 사용 힌트가 포함된 16색 팔레트

Claude Code에서는 @pyxel:examples/02_jump_game 등으로 참조하세요.

유틸리티

• pyxel_info — Pyxel 설치 정보(패키지 위치, 예제 경로, API 스텁 경로)를 가져옵니다.

Related MCP server: aseprite-mcp

시작하기

AI 에이전트(예: Claude Code)에게 Pyxel 게임을 만들어 달라고 요청하기만 하면 됩니다. 에이전트가 MCP Registry에서 자동으로 pyxel-mcp를 찾아 설정합니다.

수동 설치

1. 패키지 설치:

pip install pyxel-mcp

2. AI 에이전트에 pyxel-mcp를 MCP 서버로 등록합니다. Claude Code의 경우 프로젝트의 .mcp.json에 추가하세요:

{
  "mcpServers": {
    "pyxel": {
      "type": "stdio",
      "command": "pyxel-mcp"
    }
  }
}

MCP 레지스트리

mcp-name: io.github.kitao/pyxel-mcp

라이선스

MIT