Aseprite Live

claude mcp add aseprite-live -- uvx aseprite-live-mcp

{
  "mcpServers": {
    "aseprite-live": {
      "command": "uvx",
      "args": ["aseprite-live-mcp"],
      "env": {
        "ASEPRITE_MCP_BACKEND": "headless",           // or "live" — see below
        "ASEPRITE_PATH": "C:/Program Files/Aseprite/Aseprite.exe"
      }
    }
  }
}

一般的なインストール方法（Steam およびスタンドアロン）では、ASEPRITE_PATH を省略すると自動検出されます。

git clone https://github.com/oaktreegames/aseprite-live-mcp
cd aseprite-live-mcp
pip install -e .

• status — バックエンドの状態、このサーバーのバージョン、新しいリリースの有無を報告します。
• get_sprite_info — アクティブなスプライトのサイズ、カラーモード、レイヤー／フレーム／タグの一覧を取得します。
• get_pixel — (x, y) の合成後のピクセル（全レイヤー）を #rrggbbaa 形式で読み取ります。
• set_sprite_metadata — 型付きのキーと値のメタデータをスプライトに設定します（Aseprite の Properties システム。メタデータは .aseprite ファイル自体に保存されます）。
• get_sprite_metadata — スプライトの型付きキーと値のメタデータ（Properties）を読み取ります。
• get_pixels — 合成後のピクセル領域を #rrggbbaa 文字列のグリッドとして読み取ります。「キャンバスが今どのように見えるか」を AI に伝えるフィードバックループです。

• create_sprite — 新しいスプライトを作成します。
• expand_canvas — 各辺ごとにキャンバスを拡大します（負の値を指定すると縮小します）。コンテンツは拡大縮小されず、既存のピクセルは元の原点に対する位置を維持します。
• import_spritesheet — シート PNG をアニメーションフレームに分割します。指定されたフレームサイズでセルを行優先で読み取り、新しい「imported」レイヤーに配置します。必要に応じてフレームを追加します。

• add_layer — 新しい空のレイヤーをスタックの最上部に追加します（名前は任意で指定できます）。
• add_group — レイヤーグループを追加します。
• move_layer_to_group — レイヤーをレイヤーグループ内に移動します。
• list_layers — レイヤーツリー全体をスタックの最上部から順に表示します。名前、パス、種類（画像／グループ／タイルマップ）、表示状態、不透明度が含まれます。グループ内にネストされたレイヤーも含みます（get_sprite_info では最上位のレイヤーのみが表示されます）。
• delete_layer — 指定した名前のレイヤーを削除します。
• rename_layer — レイヤーの名前を変更します。
• set_layer_visibility — レイヤーを表示または非表示にします。
• set_layer_opacity — レイヤーの不透明度を設定します（0-255）。
• flatten_sprite — すべてのレイヤーを単一のレイヤーに統合します。
• set_layer_blend_mode — レイヤーのブレンドモードを設定します。
• duplicate_layer — レイヤーを複製し、そのレイヤーの上に配置します（セルも複製されます）。
• merge_layer_down — レイヤーを直下のレイヤーに統合します。
• move_layer — スタック内でレイヤーの順序を変更します。
• import_image_as_layer — 外部画像ファイル（PNG など）を (x, y) の位置に新しいレイヤーとして読み込みます。コンセプトアートの取り込み用の参照／トレースレイヤーとして使用できます。

• add_frame — 新しい空のフレームを末尾に追加します。
• duplicate_frame — number で指定したフレームを複製します（1 始まり）。
• delete_frame — number で指定したフレームを削除します（1 始まり）。
• set_frame_duration — number で指定したフレームの表示時間をミリ秒単位で設定します。
• add_frames — count 個の空フレームを、1 回の取り消し操作で末尾に追加します。
• set_frame_durations — [from_frame..to_frame] のすべてのフレームの表示時間を ms ミリ秒に設定します。
• reverse_frames — フレームの順序を逆にします（すべてのレイヤーのセルと表示時間も対象です）。デフォルトではスプライト全体が対象ですが、範囲を指定すると両端を含む [from_frame..to_frame] が対象になります。
• set_onion_skin — エディターのオニオンスキン表示を設定します。有効／無効、各方向のゴースト数、ゴースト表示を現在のタグ内に制限するかどうかを指定します。

• clear_cel — 指定したレイヤーとフレームのセルを空にします（透明にします）。
• set_cel_position — セルの左上の原点を (x, y) に移動します。
• set_cel_opacity — セルの不透明度を設定します（0-255）。

• get_palette — アクティブなスプライトのパレットを #rrggbbaa 形式の 16 進文字列で返します。
• set_palette_color — パレットの index 番目のエントリーを color（#rrggbb または #rrggbbaa）に設定します。
• add_palette_color — color をパレットに追加し、新しいインデックスを返します。
• set_palette — パレット全体を colors（#rrggbb/#rrggbbaa のリスト）に置き換えます。
• apply_preset_palette — パレットを組み込みプリセット（gameboy | pico8 | cga）に置き換えます。
• generate_color_ramp — base_color から暗色から明色へのシェーディングランプを生成し、順番にパレットへ追加します。palette_ramp_walk ですぐに使用できます。
• extract_palette_from_image — 外部画像ファイルからパレット（メディアンカット）を抽出し、デフォルトではアクティブなスプライトのパレットとして設定します。コンセプトアートから固定パレットへ移行する手順です。
• sort_palette — パレットの色見本を luminance（デフォルト）、hue、または saturation で並べ替えます。
• palette_from_sprite — スプライトの実際のピクセルからパレットを導出します（Aseprite の色量子化）。quantize_to_palette の逆の処理です。
• load_palette — パレットファイル（.gpl、.pal、.ase、.png ストリップなど、Aseprite が読み込める形式）からスプライトのパレットを置き換えます。
• save_palette — スプライトのパレットをファイルに書き込みます（拡張子に応じて .gpl、.pal、.png）。
• apply_bundled_palette — リソース ID を指定して、Aseprite に同梱された拡張パレットを適用します（例：DB16、DB32、ARQ4、EDG16。利用できるかどうかはインストール済みのパレット拡張機能によって異なります）。

• replace_color — アクティブなセル内で from_color に一致するすべてのピクセルを、tolerance（0～255 の RGB 距離）の範囲内で to_color に置き換えます。to_color にアルファ値が含まれていない限り、各ピクセルのアルファ値は保持されます。
• quantize_to_palette — アクティブなセルのすべての不透明ピクセルを、スプライトのパレットで最も近い色に合わせます（アルファ値は保持されます）。素材の取り込み後やシェーディング後に、パレットの規律を保つために使用します。
• adjust_hsl — HSL でアクティブなセルの色を調整します。hue_shift は度数（-360～360）、saturation は倍率（1.0 = 変更なし）、lightness は差分（-1～1）です。
• get_color_stats — 合成済みスプライトの色ヒストグラムを返します。不透明色の種類数、不透明ピクセルの合計数、使用頻度の高い上位 top 色とその数が含まれます。アート QA ワークフローでパレットのずれを確認するために使用します。

• apply_shading — パレットに制約されたシェーディングを行います。光の方向に向かって明るくし、反対側を暗くしながら、すべてのピクセルを最も近いパレット色に合わせます。
• palette_ramp_walk — 輝度が最も近い色に合わせるのではなく、光の方向に応じて、配置済みのパレットを明色または暗色の方向へ ±N インデックス分たどってシェーディングします。これにより、手動で順序を整えたシェーディングランプが尊重されます。

• paint_with_stamp — points 内の各 [x, y] に画像をスタンプします（点はスタンプの中心です）。

• draw_iso_box — 2:1 のアイソメトリックボックスを描画します。
• draw_iso_cylinder — 垂直なアイソメトリック円柱（タンク／サイロ／煙突）を描画します。上面の楕円、陰影付きの本体、手前側の縁を含み、color から自動で陰影を付けます。
• fill_polygon — 指定した points（順番に並んだ [x, y] のペアのリスト）で任意のポリゴンをスキャンライン塗りつぶしします。
• iso_recessed_panel — アイソメトリック面に、埋め込み式のドッキングソケット／ポートを描画します。暗いくぼみのある内部を、明るく照らされた縁が囲みます。

• select_rectangle — 矩形選択範囲を設定します。
• select_all — キャンバス全体を選択します。
• deselect — 現在の選択範囲を解除します。
• select_ellipse — 指定した矩形に内接する楕円を選択します。
• select_by_color — color に一致するすべてのピクセルを選択します（合成後の色を対象に、各チャンネルの許容値は 0～255）。全体を対象とするマジックワンドです。
• invert_selection — キャンバスの境界を基準に、現在の選択範囲を反転します。
• get_selection — 選択範囲の有無と、その境界矩形を返します。
• erase_area — ピクセルを透明に消去します。

• flip_sprite — スプライト全体を水平方向または垂直方向に反転します。
• resize_sprite — スプライト全体を新しいピクセル寸法に拡大縮小します。
• crop_sprite — 指定した矩形にスプライトを切り抜きます。
• rotate_sprite — スプライト全体を時計回りに 90、180、または 270 度回転します（可逆）。
• autocrop_sprite — 透明な境界を切り詰めます。すべてのレイヤーとフレームの可視コンテンツを囲む範囲にキャンバスを縮小します（Sprite > Trim）。
• set_color_mode — スプライトのカラーモードを rgb | gray | indexed の間で変換します。

• create_slice — 指定した矩形に名前付きのスライス（アトラス領域）を作成します。
• set_slice_pivot — スライスの左上を基準としたピクセル単位で、スライスのピボットポイントを設定します。
• set_slice_center — スライスの 9 パッチ伸縮可能領域の中央の矩形を設定します（スライスを基準とします）。
• list_slices — すべてのスライスについて、境界、ピボット、9 パッチの中央を一覧表示します。
• delete_slice — 指定した名前のスライスを削除します。

• create_tag — name という名前のアニメーションタグを作成し、フレーム from_frame～to_frame に設定します（1 始まり）。
• delete_tag — name という名前のアニメーションタグを削除します。
• list_tags — フレーム範囲とともにアニメーションタグを一覧表示します。
• rename_tag — アニメーションタグ old_name を new_name に変更します。
• set_tag_color — タグ name のタイムラインラベルの色を設定します（#rrggbb または #rrggbbaa）。
• set_tag_range — タグ name の範囲をフレーム from_frame～to_frame に変更します（1 始まり、両端を含む。スプライトのフレーム数に対して検証されます）。
• set_tag_direction — タグ name の再生方向を設定します：forward | reverse | pingpong | pingpong_reverse。

• tween_frames — from_frame と to_frame の間に count 個の中間フレームを挿入し、セルの位置を補間します（開始セルの画像を移動させるモーショントゥイーンです）。
• tween_cel_opacity — [from_frame..to_frame] の範囲でレイヤーのセルをフェードさせます。選択したイージングを使い、不透明度を from_opacity から to_opacity（0-255）まで補間します。
• smear_frame — from_frame と to_frame をブレンドしたモーションスミアフレームを追加します。重なり合うピクセルは平均化され、片方のフレームにしかない領域はアルファ半分で残像化されます。ピクセルコンテンツのスミアです。
• frame_diff — 2つの合成フレームをピクセル単位で正確に比較します。変更されたピクセル数と割合、変更部分のバウンディングボックス、同一かどうかを返します。
• render_onion_composite — 指定したゴースト opacity で、最大 prev 個前のフレームを赤、最大 next 個後のフレームを青の残像として重ねた frame の PNG を書き出します（Aseprite のオニオンスキン方式）。1枚の画像でモーションアークを 確認 できます。

• export_sprite — アクティブなスプライトをファイルにエクスポートします。形式は out_path の拡張子（.png、.gif、...）で決まります。
• export_spritesheet — すべてのフレームを1枚のスプライトシート画像にまとめます（オプションで data_path に JSON アトラスを書き出します）。
• export_layers — すべての画像レイヤー（グループ内も再帰的に処理）をそれぞれ PNG として out_dir にエクスポートします。ファイル名は <sanitized-layer-name>.png です。
• export_tags — 各アニメーションタグのフレーム範囲を、それぞれ out_dir にエクスポートします。アニメーション GIF（format="gif"、デフォルト）の <tag-name>.gif、または横並びの PNG ストリップ（format="png"）の <tag-name>.png です。

• export_unity_sprite — 横並びのスプライトシートをエクスポートし、その隣に Unity の .meta を書き込みます。各フレームを名前付きの Multiple モードのスプライトとしてあらかじめスライスします。1回の操作で完了し、Sprite Editor で手動作業する必要はありません。
• export_unity_slices — スプライトを1枚の PNG としてエクスポートし、Unity の .meta を書き込みます。名前付きスライスごとに Multiple モードのスプライトを1つ作成し、それぞれのスライスのピボットを設定します。スライスを配置したアトラスを Unity にインポートすると、スライスとピボットが設定された状態になります。

• measure_padding — コンテンツ周囲の透明な「ステッカー」余白を計測します。コンテンツのバウンディングボックス、各辺の余白（左／右／上／下）、塗りつぶし率、不透明な色の種類数を返します。
• qa_sweep — アクティブなスプライトをプロジェクトの規約に照らして監査し、各チェックの合否を返します。

• batch_export — folder 内のすべての .aseprite を（最初のフレームから）画像にエクスポートします。オプションで scale による整数倍の拡大ができます。
• batch_resize — folder 内のすべての .aseprite を（最初のフレームから、ニアレストネイバー方式で）リサイズし、画像を out_dir に書き出します。
• batch_apply_palette — folder 内のすべての .aseprite をパレットに合わせます。各スプライト（最初のフレーム、アルファを保持）の色をパレットにスナップし、画像を out_dir にエクスポートします。

• get_editor_state — ライブエディター専用：現在のズーム、スクロール位置、マウスが指しているスプライト上のピクセルを取得します。エージェントはアーティストが見ている場所を把握できます。
• set_editor_view — ライブエディター専用：ビューポートのズーム（1.0 = 100%）やスクロール位置を設定します。たとえば、編集する領域にズームして、アーティストが作業を見られるようにします。
• set_symmetry — ライブエディター専用：ミラー描画の対称設定を行います。mode は none、horizontal（垂直軸を挟んだ反転）、vertical、both のいずれかで、軸線の位置も指定できます。
• ask_point — ライブエディター専用：キャンバス上の点（ピボット、アンカー、描画原点）をクリックするようアーティストに依頼します。
• get_asked_point — ask_point の結果をポーリングします。待機中は done が false で、クリック後は x／y が返されます（アーティストが Esc キーを押した場合は cancelled）。
• cancel_ask_point — 保留中の ask_point リクエストを取り消します（たとえば、アーティストが席を外したため次に進む場合）。
• show_choice_dialog — ライブエディター専用：メッセージと最大4つの選択ボタン（承認／やり直しなど）を含む小さなダイアログを Aseprite 内に表示します。
• get_dialog_choice — show_choice_dialog の結果をポーリングします。ダイアログが開いている間は done が false で、選択後は選択されたボタンのテキストが返されます。
• watch_changes — ライブエディター専用：アーティストがアクティブなスプライトに加えた編集のカウントを開始します（Sprite.events 経由）。
• get_watched_changes — watch_changes で開始した変更カウンターをポーリングします（reset=True にすると、読み取り後にカウンターをゼロにします）。
• stop_watching_changes — watch_changes のリスナーを解除します。

• run_lua — Aseprite 内で任意の Lua を実行し、その結果を返します（高度なエスケープハッチであり、ローカルコード実行と同等です）。