Illustrator MCP Server

Illustrator MCP サーバー

Adobe Illustrator を操作する MCP サーバーです。ドキュメント、アートボード、レイヤー、図形とパス、テキスト、カラー、パスファインダー操作、書き出しに対応しています。Illustrator がインストールされているマシン上で動作し、Illustrator に付属するスクリプトインターフェイスである ExtendScript を介して Illustrator と通信します。

macOS または Windows の Illustrator 2023 以降、および Node.js 18 以降が必要です。

インストール

Claude Code：

claude mcp add illustrator -- npx -y adobe-mcp-illustrator

mcpServers ブロックを読み込むクライアント（Claude Desktop、Cursor、Warp など）：

{
  "mcpServers": {
    "illustrator": {
      "command": "npx",
      "args": ["-y", "adobe-mcp-illustrator"]
    }
  }
}

macOS では、最初の呼び出し時に Illustrator の制御許可を求められます（システム設定 > プライバシーとセキュリティ > オートメーション）。

規則

• 位置とサイズの単位はポイント（72 pt = 1 in）です。アートボードの左上隅（artboardIndex、既定値は 0）を基準に測定し、y は下方向に増加します。Illustrator 自体のドキュメント座標は上方向に増加しますが、サーバーが両方向の変換を行い、大きなキャンバスのドキュメントにも対応します。
• アイテムは target を使って選択します：{ ids: [...] }、{ names: [...] }、または { selection: true }。ID は Illustrator 独自のアイテム ID（PageItem.uuid）で、list_items およびアートワークを作成する各ツールから取得できます。
• カラーは、スウォッチ名、"#RRGGBB"、"rgb(r,g,b)"、"cmyk(c,m,y,k)"、"gray(g)"、または "none" です。ドキュメントのカラーモードは作成時に固定されるため、create_document で指定します。
• フォントは PostScript 名です。list_fonts で確認できます。
• ファイルは、ホームフォルダー内、または ILLUSTRATOR_ALLOWED_DIRS に指定されたディレクトリ内に置く必要があります。

ツール

領域	ツール
ドキュメント	get_document_info、list_documents、create_document、open_document（AI、トリミングボックスを指定したPDFページ、EPS、SVG、読み込みオプション付きAutoCAD、画像、CGM、CorelDRAW、EMF/WMF、Word、RTF、テキスト）、save_document（.aiまたは.eps、各アートボードを個別ファイルに保存、旧バージョン向けの透明度）、close_document
ドキュメントコマンド	new_from_template、save_document_copy、revert_document、close_all_documents、list_document_presets、create_document_from_preset（名前、サイズ、向き、単位、カラーモード、ラスタライズ効果、プレビューモード、透明グリッド、裁ち落とし）、get_document_setup、set_document_setup（カラーモード、ルーラーの原点、大きなキャンバス、「アートボードを編集」）、open_document_with_options（旧形式のファイル、最近使用したファイル、ライブラリとして開く）、get_file_info、set_file_info（ファイル情報とXMP）、use_clipboard（カット、コピー、ペースト、同じ位置にペースト、すべてのアートボードにペースト、書式なしでペースト）、switch_document
アートボード	list_artboards、add_artboard、set_artboard（向き、アートワークを一緒に拡大・縮小）、delete_artboard、set_active_artboard、fit_artboard_to_artwork（選択したアートまたはアートワークの境界）、rearrange_artboards、copy_artboard（複製、カット、別のドキュメントにコピー）、delete_empty_artboards、align_artboards、reorder_artboards、convert_to_artboards、set_artboard_display（センターマーク、十字線、ビデオセーフエリアとルーラー、ルーラーの原点、境界線、アートボードの表示／非表示）、view_artboard
レイヤー	list_layers、create_layer、set_layer_properties（レイヤーオプション、ノックアウト）、set_active_layer、delete_layer、move_items_to_layer（または「現在のレイヤーに送る」）、organize_layers（結合、統合、新規レイヤーに収集、レイヤーに分配、順序を反転）、set_other_layers（他のレイヤーを非表示、ロック、またはアウトライン表示）、select_layer_artwork、paste_artwork（前面または背面にペースト）
シェイプとパス	create_rectangle、create_ellipse、create_polygon、create_star、create_line（終点、または長さと角度）、create_path、create_arc、create_spiral、create_rectangular_grid、create_polar_grid（それぞれのツールのダイアログオプション付き）
ライブシェイプ	convert_live_shapes（シェイプに変換、シェイプを拡張）、toggle_corner_widget
テキスト	create_text、set_text_style、set_text_contents、convert_text_to_outlines、list_fonts
タイポグラフィ	set_character_attributes（文字、OpenType、CJKオプション。テキストフレーム、文字範囲、または選択したテキストに適用）、adjust_text（サイズ、カーニングとトラッキングのステップ、トラッキングを解除、均等配置、見出しに合わせる）、set_paragraph_attributes（インデント、間隔、ハイフネーション、両端揃え、コンポーザー、CJKオプション）、set_tab_stops、get_text_attributes、list_text_styles、create_text_style、edit_text_style、delete_text_styles、apply_text_style（オーバーライドを解除する機能も含む）、load_text_styles、set_text_frame_options（ポイント文字／エリア内文字の切り替え、エリア内文字オプション、オプティカルマージン、アンチエイリアス）、thread_text_frames
文字	create_path_text（パス上文字、シェイプ内のエリア内文字）、set_path_text（パス効果、開始位置と終了位置、間隔、反転、旧形式の更新）、change_case、insert_special_character（記号、ダッシュ、引用符、スペース、強制改行）、apply_smart_punctuation、fill_placeholder_text、run_type_command（箇条書きをテキストに変換、隠し文字を表示、自動スペルチェック）、list_document_fonts（不足しているフォントを含む）、replace_font、find_replace_text（大文字と小文字を区別、単語単位で検索）、set_text_wrap、list_stories、update_legacy_text、set_text_orientation、import_text、export_text、set_asian_type（コンポーザー、禁則処理、文字組み、詰め、アキ、縦中横、割注）、set_right_to_left_text（方向、中東言語用コンポーザー、数字、カシーダ）
アピアランス	set_fill、set_stroke（どちらも特色およびグローバルスウォッチ、またはグラデーションスウォッチの濃度を指定可能）、set_opacity、get_appearance、create_gradient
グラフィックスタイルと塗り／線のコントロール	list_graphic_styles、apply_graphic_style（置き換えまたは結合）、rename_graphic_style、delete_graphic_styles、save_graphic_style_library、open_graphic_styles（パネルまたは組み込みライブラリ）、add_appearance_attribute（別の塗りまたは線）、set_transparency_group（ノックアウト、描画モードを分離）、toggle_view_option（透明グリッド、ライブペイントの隙間）、get_default_fill_stroke、set_default_fill_stroke、swap_fill_stroke、reset_fill_stroke
ライブペイント	make_live_paint（作成または結合）、release_live_paint、expand_live_paint
カラー	list_swatches、create_swatch（プロセス、グローバル、特色、Lab値から作成する特色）、create_swatch_group、delete_swatches、add_used_colors、edit_colors（CMYK、RGB、またはグレースケールに変換、反転、ブレンド）
スウォッチ管理	edit_swatch（スウォッチオプション：名前、カラー、プロセス／グローバル／特色）、duplicate_swatches、merge_swatches、find_unused_swatches、add_current_color、edit_swatch_group（カラーグループ）、open_swatch_library、load_swatch_library（組み込みライブラリまたは.aiファイル、グラデーションプリセット）、save_swatch_library（スウォッチライブラリをAIとして保存、またはライブラリに追加）
色の再配色とグラデーション	adjust_colors（スクリプトによる調整：彩度を上げる、カラーバランスを調整、補色、ウェブセーフカラー、印刷可能カラー。アイテムまたはカラーグループに適用）、overprint_black、apply_gradient（グラデーションツールの配置、複数のオブジェクトにまたがる単一グラデーション、定義済みグラデーション）
カラーマネジメント	get_color_settings（設定ファイル、ドキュメントプロファイル）、load_color_settings、set_color_view（校正設定、校正色、グラデーション注釈ツール）
選択と配置	list_items、get_selection、select_items、select_same、select_all、deselect_all、delete_items、duplicate_items、move_items、scale_items、rotate_items、reflect_items、align_items（選択範囲、アートボード、またはキーオブジェクトに整列）、arrange_items、group_items、ungroup_items（1階層、または「すべてグループ解除」ですべての階層）
結合	make_clipping_mask、make_compound_path、pathfinder（ハードミックス、ソフトミックス、トラップも含む）
パス	path_operation（線をアウトライン化、連結、アンカーポイントを追加、方向を反転、背面のオブジェクトを分割、複合パスを解除、ピクセルグリッドに最適化、アピアランスを分割・拡張）、average_points（連結も含む）、clean_up、split_into_grid、split_path、set_path_options（塗りのルール、ガイド、ピクセル整列）、get_path_info（面積、長さ、アンカーポイント）
効果	apply_effect（ドロップシャドウ、内側／外側の光彩、ぼかし、スクラブル、角を丸くする、シェイプに変換、自由変形、パンク・膨張、ラフ、変形、微調整、旋回、ジグザグ、15種類のワープ、パスのオフセット、オブジェクトと線をアウトライン化、トンボ、ラスタライズ、ガウスぼかし、NTSCカラー）、apply_svg_filter、apply_last_effect、set_raster_effect_settings
変形	transform_each（ランダム、コピー）、shear_items、apply_matrix、repeat_transform（変形の繰り返し）、resize_items（幅と高さ、相対値または絶対値）、get_bounds（幾何学的境界、表示境界、コントロール境界）、nudge_items、set_transform_options（基準点、角を拡大・縮小、バウンディングボックス）、reset_bounding_box、distribute_items（端、中心、間隔、正確な間隔）、distort_items（自由変形と遠近変形）
エンベロープとパス上のオブジェクト	make_envelope（最前面のオブジェクトを使用）、edit_envelope（解除、拡張、内容を編集）、expand_objects_on_path
選択	select_by_type（選択＞オブジェクト：テキスト、ポイント文字とエリア内文字、クリッピングマスク、孤立点、ブラシストローク、ピクセルに整列していないオブジェクト、同じレイヤー、方向線ハンドル）、change_selection（再選択、反転、前面または背面のオブジェクトを選択）、select_nested_items（グループ内、または1階層上のグループ）、select_similar_items（許容値内の線幅と不透明度、描画モード）、toggle_global_edit、lock_itemsおよびhide_items（対象、アートワークの前面、またはその他すべて）、unlock_all、show_all、set_isolation_mode
クリッピングマスク	release_clipping_mask、edit_clipping_mask（マスクを編集、内容を編集）、add_to_clipping_mask（クリップグループに追加、または「内側描画」と同様にパスを囲む形で追加）、remove_from_clipping_mask
グラフとメッシュ	list_graphs、apply_graph_data（変数ライブラリを読み込み、データセットを表示）、list_meshes
パス編集	edit_anchor_points（削除、コーナーまたはスムーズに変換、アンカーポイントとハンドルを設定）、copy_items（別のドキュメントまたはクリップボードにコピー）、simplify_path（曲線の精度、角度のしきい値、直線）、compound_shape（シェイプモードで作成、解除、拡張）、repeat_pathfinder、intertwine（作成、解除）
ブレンド	make_blend（ブレンド文字の作成時にテキストをアウトライン化するオプション）、set_blend_options（ステップ数、方向）、release_blend、expand_blend、reverse_blend、replace_blend_spine
環境設定とツール	get_preferences、set_preferences、select_tool（グラフ、メッシュ、ブレンド、プリント分割ツールを含む）
配置と書き出し	place_image（画像、PDFページ、EPSとDCS、SVG、AI、AutoCAD、CGM、CorelDRAW、EMF/WMF）、export_png（倍率またはサイズに合わせる、マット、HTML）、export_jpeg、export_svg（SVG形式で保存：プロファイル、フォントのサブセット化、エンコーディング、XMP、スライス、テキストオプション）、export_web_svg（SVG形式で書き出し：スタイル、ID、圧縮、レスポンシブ）、export_for_screens（アートボード、アセット、ドキュメント全体。倍率、幅、高さ、または解像度で指定。形式ごとの詳細設定）、export_pdf（プリセットに加え、PDF/X、圧縮とダウンサンプリング、フォントのサブセット化、裁ち落とし、マーク、カラー変換、出力インテント、透明部分の分割・統合、パスワードと権限、Acrobatレイヤー）
変数とデータセット	list_variables、create_variable、bind_variable、delete_variables、create_data_sets（テキスト、画像ファイル、表示／非表示のレコードから作成）、show_data_set、delete_data_sets、export_data_sets（各データセットをPNGまたはJPEGに書き出し）、import_variables、export_variables、set_variables_locked
プリプレスとプリント	set_overprint、make_trap_stroke、flatten_transparency、toggle_prepress_view（オーバープリントプレビュー、プリント分割、分版プレビュー、分割・統合プレビュー、属性）、create_trim_marks、list_print_settings、print_document（プリンターまたはPostScriptファイルに出力。プリセットに加え、プリントダイアログの各ページとドキュメントのインキオプション）
3D	apply_3d_effect（押し出し、回転体、膨張、回転：「3Dとマテリアル」効果、または回転、遠近、表面を設定できる3Dクラシック）
ブラシ	list_brushes、apply_brush（アウトラインに拡張する機能も含む）、import_brushes（ライブラリファイルから）、save_brush_library、open_brush_library
遠近グリッド	set_perspective_grid（プリセット、表示／非表示、アクティブな平面、平面をオブジェクトに合わせる、「表示」メニューの切り替え）、attach_to_perspective、release_perspective、import_perspective_presets、export_perspective_presets
パターンとリピート	create_pattern（オブジェクト＞パターン＞作成）、apply_pattern（塗りまたは線）、rename_pattern、edit_pattern（パターン編集モードの開始または終了）、transform_pattern（パターンのみを移動、拡大・縮小、回転、反転、またはシアー）、make_repeat（オプション付きのラジアル、グリッド、またはミラー）、set_repeat_options、release_repeat
画像トレース	trace_image（プリセットと画像トレースパネルの全オプション。必要に応じて拡張）、set_trace_options（再トレース、プリセットとして保存）、get_trace_info（パス、アンカーポイント、カラー）、expand_trace、release_trace、list_tracing_presets
シンボル	list_symbols（インスタンス数、未使用のシンボル）、create_symbol（基準点、アートを置き換え）、place_symbol、replace_symbol、select_symbol_instances、break_symbol_link、rename_symbol、duplicate_symbol、delete_symbols（未使用のシンボルをすべて削除することも可能）、open_symbol_library（組み込みまたはファイル）、save_symbol_library
その他の形式	export_psd（レイヤー、編集可能なテキスト、カラーモデル、解像度）、export_tiff（LZW、バイト順、カラーモデル、解像度）、export_web_image（カラー数、減色方式、ディザ、マット、非可逆GIFを指定したGIFとPNG-8）、export_autocad（DWGまたはDXF：バージョン、倍率、カラー、ラスタ形式）、export_selection_as_ai、place_text_file
アセットの書き出しとスライス	list_assets、collect_assets（1つのアセットとして、またはアイテムごとに収集）、rename_asset、remove_assets、export_selection（PNGまたは.ai）、list_slices、edit_slices（作成、解除、選択範囲またはガイドから作成、複製、結合、アートボードにクリップ、すべて削除、表示／非表示、ロック、長方形をスライス）、set_item_url（イメージマップとスライスのURL）
画像とリンク	list_images（ステータスとファイル詳細を含むリンク、埋め込み画像、埋め込みファイル、非ネイティブアートとプラグインアート）、relink_images（1つのファイル、すべてのインスタンス、フォルダーから見つからないリンクを再リンク）、update_links（リンクを更新または埋め込み）、go_to_link、place_images（複数ファイルをグリッドに配置、Photoshopの読み込みオプション）、rasterize_items（ラスタライズの全オプション）、crop_image、colorize_image、run_image_command（背景を削除、モックアップを作成または解除）
アクションと自動化	list_actions（アクションパネルのセット、または.aiaファイル内の手順）、play_action、load_actions（アクションを読み込みまたは置換。読み込み前にアクションの名前変更、削除、手順の削除、手順やそのダイアログのオン／オフ切り替えが可能）、create_action_set（保存した手順から新しいアクションを作成）、unload_actions（アクション、セット、または「アクションを消去」）、run_batch（スクリプトによるバッチ処理：ファイルのフォルダーまたはすべてのデータセットを指定先に処理）、run_script_file、import_csv_data（CSVデータソースをデータセットとして読み込み）、get_item_dataおよびset_item_data（タグとメモ）
ユーティリティ	illustrator_status、execute_menu_command、find_menu_commands、execute_illustrator_code、help
help({ tool }) は、各ツールのパラメーターを説明します。

邪魔にならない仕組み

• ダイアログを表示しません。 各スクリプトは実行中、Illustrator の警告をオフにし、スクリプトが失敗した場合も含め、実行後に設定を元に戻します。そのため、警告によって呼び出しが待ち続けることはありません。
• 設定は元に戻ります。 スクリプトが使用する座標系は、そのスクリプトの実行中に設定され、実行後に元に戻ります。
• タイムアウトの理由を示します。 Illustrator が ILLUSTRATOR_SCRIPT_TIMEOUT_MS（デフォルトは 120 s）以内に応答しない場合、エラーには Illustrator でダイアログが開いている可能性が高いことが示されます。
• メニューコマンドを検証します。 Illustrator は、知らないメニューコマンド名を無視し、認識しているコマンドに対しては何も報告しません。execute_menu_command は既知の 859 個の名前のみを受け付け（allowUnknown を渡した場合を除く）、コマンド実行後の選択状態とドキュメントの状態を返すため、実行結果を確認できます。
• ライブエフェクトと環境設定には、公開されている実践例を使用します。 Adobe は、apply_effect と pathfinder が applyEffect に渡す LiveEffect XML も、set_preferences の背後にある環境設定キーも文書化していません。このサーバーでは、公開スクリプトで使用されているパラメーターとキーのみを使い、その出典をケイパビリティアトラスに記録しています。pathfinder は method: "menu" を指定すると、Illustrator のメニューコマンドにフォールバックできます。Photoshop エフェクト（エフェクトギャラリー、アーティスティック、スケッチ、テクスチャなど）は提供していません。各コマンドでダイアログが開き、LiveEffect パラメーターは、公開スクリプトで設定されたことのないエンコード済みバイナリとして保存されるためです。ダイアログを開かない NTSC Colors は例外です。
• 一時的なアクションを使ってコマンドを実行します。 オブジェクトモデルでは、ブレンドのステップ数や方向の設定、簡略化、パスファインダーの複合シェイプの作成、透明の分割・統合ができません。そのため、make_blend、set_blend_options、simplify_path、compound_shape、flatten_transparency は、1 ステップのアクションを作成し、ダイアログを閉じて再生した後、アクションをアンロードします。アクションのパラメーターには、公開スクリプトや記録済みアクションセットで使用されているものを使います。
• ダイアログの処理はスクリプトで行います。 平均、クリーンアップ、グリッドに分割、個別に変形、バッチ、一部のカラー編集コマンドはダイアログを開くため、サーバーは代わりにオブジェクトモデルを使って各ダイアログの処理を実行します。スムーズとパスのオフセットには代替手段がないため、提供していません（パスのオフセットには apply_effect の offset_path と expand を使用できます）。
• アクションはファイルとして編集します。 Illustrator はアクションの再生、読み込み、アンロードはできますが、読み込み済みのアクションの一覧表示や変更はできません。list_actions は AiCommandPalette と同様に Illustrator の環境設定からセットを読み込み、load_actions と create_action_set は .aia ファイルを変更してから読み込みます。run_batch はバッチダイアログと同じ処理をファイルごとに 1 回ずつ実行するため、大規模なバッチでもタイムアウトしません。
• レコードからデータセットを作成します。 Illustrator はアートワークの現在の状態からデータセットを取得します。そのため create_data_sets は、公開されている変数スクリプトと同様に、バインドされたオブジェクトに各レコードの値を設定してから取得します。
• スクリプトに生の入力値を渡しません。 呼び出し元から渡されるすべての値を検証し、リテラルとしてスクリプトに書き込みます。

設定

変数	用途
ILLUSTRATOR_APP_NAME	macOS：特定のコピーを指定します（例：Adobe Illustrator 2025）。デフォルトでは、サーバーは Illustrator をバンドル ID で指定します。
ILLUSTRATOR_ALLOWED_DIRS	ファイルを開く、配置する、書き出すための追加ディレクトリ（macOS では : 区切り、Windows では ; 区切り）。
ILLUSTRATOR_SCRIPT_TIMEOUT_MS	Illustrator の応答を待つ時間。デフォルトは 120000 です。
ILLUSTRATOR_BACKEND / ILLUSTRATOR_TARGET	artcraft または vectorcraft を設定すると、ループバック JSON 行経由でツール呼び出しを VectorCraft にルーティングします。デフォルトは auto です（Adobe Illustrator が実行されていない場合、ポート 7979 で待ち受けている VectorCraft にルーティングします）。
VECTORCRAFT_CONTROL_PORT	VectorCraft の制御チャネルのポート。デフォルトは 7979 です。
VECTORCRAFT_CONTROL_TOKEN	必要な場合に使用する、VectorCraft 認証用のトークン。

開発

npm test         # definitions, argument parsing, protocol, and the static script audit
npm run audit    # the audit alone, with findings listed
npm run check    # syntax check

静的監査では、サンプル引数を使って各ツールをスタブ化された Illustrator に対して実行し、生成されたスクリプトが ES5 として解析できること、 および Illustrator のスクリプティングオブジェクトモデル（2022～2025）に含まれる 名前のみを使用していることを確認します。Illustrator 上では実行しません。この監査に 合格したツールが、アプリケーションで実行済みであるとは限りません。

共有インフラストラクチャ（スクリプトのエスケープ処理、エグゼキューター、サーバーの シェル、監査）は、adobe-mcp-core から 提供されています。これは adobe-mcp-indesign と共有される基盤です。

ライセンス

MIT。メニューコマンドのデータについては、LICENSE と NOTICE を参照してください。