aseprite-mcpとは?
GitHubユーザーgiangdvdotdevによるaseprite-mcpは、uvx aseprite-mcpで動くPythonのMCPサーバーと、Aseprite 1.3以降の中で読み込まれるLua拡張を組み合わせたものです 。両者は127.0.0.1:9876のWebSocketでやり取りするので、エージェントは裏でファイルを扱うのではなく、エディタで開いているスプライトそのものを操作します。
アクティブなスプライトに作用する30のツールを登録します。スプライトとレイヤーの作成、ピクセルの一括描画、線、四角形、楕円、塗りつぶし、消去、キャンバス画像、ピクセル、領域、レイヤー、選択範囲の読み取り、取り消しとやり直し、フレームの追加、表示時間の設定、削除、ファイルを開くことと保存、PNGとスプライトシートの書き出しです。リポジトリはMITライセンスで、スターは約13、コミットは5件、バージョン0.6.0がPyPIにあります。
aseprite-mcpのインストール方法
uvx aseprite-mcpaseprite-mcpは使う価値があるか?
aseprite-mcpは、多くの画像系サーバーが省いていることをきちんとやっています。エージェントが自分の描いたものを見られることです。get_canvas_imageとピクセルや領域の読み取りで、モデルは描く合間にスプライトを確かめられ、エディタは変更をその場で映します。取り消しとやり直しもツールになっているので、失敗した描画は人がキーボードに触れなくても戻せます。
出来栄えを決めるのはサーバーではなくモデルです。READMEのギャラリーには、Opus 5のClaude Codeが描いた犬の歩行サイクルと写真をもとにした肖像、そして12 GBのRTX 3060で動くローカルのGemma 4 26Bモデルが描いたゴムのアヒルが載っており、小さなローカルモデルでも動かせる心強い証 拠です。ツール呼び出しで描くのは遅く、小さなスプライトを超えるとトークンを大量に使います。30のツールには、パレットやタイルマップを扱うものがありません。
READMEはセキュリティの立場をはっきり書いています。WebSocketには認証がありません。127.0.0.1にバインドするので他のマシンからは届きませんが、サーバーが動いている間は同じコンピューター上のどのプロセスもAsepriteを操作できます。export_png、save_sprite、export_spritesheetは渡された任意の絶対パスに書き込み、そこにあるものを上書きするので、混乱したエージェントがプロジェクト外のファイルを壊すおそれがあります。
一人で作っているプロジェクトで、公開履歴のコミットは5件です。テストはサーバー用のpytestとプラグイン用のLuaランナーの2つで、Asepriteを開かずに動きます。ポートを取り決める仕組みはないので、ASEPRITE_MCP_PORTは両側で一致させる必要があります。既定の9876は、2つのAbletonサーバーが使う9877の隣で、READMEのポート変更の例はまさに9877を選んでいるため、どちらとも衝突します。
真価を発揮する場面
2Dプラットフォーマーを一人で作っている開発者
32×32の敵スプライトと短い歩行サイクルの下描きをする
スプライトを頼み、次に表示時間を決めたフレームを追加させ、スプライトシートをゲームのアセットフォルダへ直接書き出します。モデル以外は無 料ですが、細部は自分で描き直す前提です。
3人のゲームジャムチーム
他のメンバーがコードを書く間に仮の絵を画面に出す
一人がAsepriteでエージェントに指示し、その下描きでゲームプレイを試して後で差し替えます。ギャラリーのRTX 3060の例のようにローカルモデルを使えば、APIの費用はゼロです。
ドット絵の講師
形が1ピクセルずつどう組み上がるかを生徒に見せる
生徒は共有画面でエージェントが描くのを見て、取り消しで描画を一つずつさかのぼり、自分の手で描き直します。かかるのは動かすモデルの費用だけです。
導入前に確認すること
- 導入
- クライアントにuvx aseprite-mcpを追加し、最新リリースの.aseprite-extensionファイルをインストールし、Asepriteを再起動して、View > Consoleに[MCP] Connected.と出るのを確かめます。どちらを先に起動してもよく、プラグインはサーバーが現れるまで再接続を試みます。
- 連携
- Claude Code、Claude Desktopな どのstdioクライアントで使えます。ギャラリーによれば、Pi Agentのようなエージェントを通じてローカルモデルも使えます。Aseprite 1.3以降が必要です。
- データとプライバシー
- すべてローカルで動きます。エージェントが読み取ったキャンバス画像やピクセルはモデル提供元に送られます。127.0.0.1:9876のWebSocketには認証がありません。
- 制限
- 30のツールはすべてアクティブなスプライトが対象で、パレットやタイルマップのツールはありません。ASEPRITE_MCP_PORTは両側で一致させる必要があり、保存と書き出しのツールは任意の絶対パスのファイルを上書きします。
良い点
- 本物のエディタでライブに描き、その様子が見える
- キャンバスの読み取りでモデルが自分の絵を確かめられる
- 簡単なアニメーション向けのフレームとスプライトシート書き出し
- ギャラリーによれば小さなローカルモデルでも動く
気になる点
- ローカルのWebSocketに認証がない
- 書き出しツールが任意の絶対パスを上書きする
- 入れる部品が2つあり、ポートは手で合わせる
- 保守者は一人でスターは約13
おすすめの人
Asepriteを使うインディーゲーム開発者や趣味の人で、小さなスプライトや簡単なアニメーションサイクルの下描きをエージェントに任せ、仕上げは自分でしたい人に向いています。