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 — 2つのフレームのスクリーンショットを比較し、ピクセルの違いを報告します

視覚分析

• inspect_sprite — Pyxelイメージバンクからスプライトのピクセルデータを検査します

• inspect_layout — 画面レイアウト、テキスト配置、視覚的バランスを分析します

• inspect_palette — Pyxelスクリーンショット内の色の使用状況とコントラストを分析します

• inspect_bank — Pyxelイメージバンク全体を1枚のスクリーンショットとして可視化します

• 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