illustrator-mcp-server 1.3.2 → 1.5.0

package/README.ja.md

@@ -1,12 +1,12 @@
-**[English version](README.md)**
+[🇺🇸 English](README.md) | **🇯🇵 日本語** | [🇨🇳 简体中文](README.zh-CN.md) | [🇰🇷 한국어](README.ko.md) | [🇪🇸 Español](README.es.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇵🇹 Português (BR)](README.pt-BR.md)
 
 # Illustrator MCP Server
 
-[![npm](https://img.shields.io/npm/v/illustrator-mcp-server.svg)](https://www.npmjs.com/package/illustrator-mcp-server)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Platform](https://img.shields.io/badge/Platform-macOS%20%7C%20Windows-lightgrey.svg)]()
-[![Illustrator](https://img.shields.io/badge/Illustrator-CC%202024%2B-orange.svg)](https://www.adobe.com/products/illustrator.html)
-[![MCP](https://img.shields.io/badge/MCP-Compatible-purple.svg)](https://modelcontextprotocol.io/)
+[![npm](https://img.shields.io/npm/v/illustrator-mcp-server.svg?style=flat-square&colorA=18181B&colorB=18181B)](https://www.npmjs.com/package/illustrator-mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-18181B.svg?style=flat-square&colorA=18181B)](LICENSE)
+[![Platform](https://img.shields.io/badge/Platform-macOS%20%7C%20Windows-18181B.svg?style=flat-square&colorA=18181B)]()
+[![Illustrator](https://img.shields.io/badge/Illustrator-CC%202024%2B-18181B.svg?style=flat-square&colorA=18181B)](https://www.adobe.com/products/illustrator.html)
+[![MCP](https://img.shields.io/badge/MCP-Compatible-18181B.svg?style=flat-square&colorA=18181B)](https://modelcontextprotocol.io/)
 [![Ko-fi](https://img.shields.io/badge/Ko--fi-FF5E5B?style=flat&logo=ko-fi&logoColor=white)](https://ko-fi.com/cyocun)
 
 Adobe Illustrator のデザインデータを読み取り・操作・書き出しする [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) サーバー — 63 のツールを内蔵。
@@ -15,6 +15,25 @@ Claude などの AI アシスタントから Illustrator を直接操作し、We
 
 ---
 
+## 🎨 ギャラリー
+
+以下の作品はすべて、Claude との自然言語の会話だけで制作されています。Illustrator の手動操作は一切行っていません。
+
+<table>
+<tr>
+<td align="center"><img src="docs/images/example-event-poster.png" width="300" alt="イベントポスター — SYNC TOKYO 2026" /><br><b>イベントポスター</b></td>
+<td align="center"><img src="docs/images/example-logo-concepts.png" width="300" alt="ロゴコンセプト — Slow Drip Coffee Co." /><br><b>ロゴコンセプト</b></td>
+</tr>
+<tr>
+<td align="center"><img src="docs/images/example-business-card.png" width="300" alt="名刺 — KUMO Studio" /><br><b>名刺</b></td>
+<td align="center"><img src="docs/images/example-twilight-geometry.png" width="300" alt="Twilight Geometry — 幾何学的抽象風景画" /><br><b>Twilight Geometry</b></td>
+</tr>
+</table>
+
+> 詳しいプロンプトや使用ツールは[作例の詳細](#作例-smpte-テストパターン)をご覧ください。
+
+---
+
 > [!TIP]
 > このツールの開発・維持には費用がかかっています。
 > 役に立ったらぜひ応援お願いします — [☕ コーヒー奢ってください!](https://ko-fi.com/cyocun)
@@ -271,7 +290,7 @@ Claude Desktop のプロンプト一覧から選択できるワークフロー
 
 </details>
 
-### 操作系 (37)
+### 操作系 (39)
 
 <details>
 <summary>クリックして展開</summary>
@@ -283,7 +302,8 @@ Claude Desktop のプロンプト一覧から選択できるワークフロー
 | `create_line` | 直線の作成 |
 | `create_text_frame` | テキストフレームの作成（ポイント/エリア） |
 | `create_path` | 任意パスの作成（ベジェハンドル対応） |
-| `place_image` | 画像ファイルの配置（リンク/埋め込み） |
+| `place_image` | ラスター/PDF画像ファイルの配置（リンク/埋め込み）。SVG は拒否される — `import_svg_as_editable` を使用 |
+| `import_svg_as_editable` | SVG ファイルを編集可能なパス・テキスト・グループとして取り込み（リンク画像ではなく編集可能オブジェクトとして） |
 | `modify_object` | 既存オブジェクトのプロパティ変更 |
 | `convert_to_outlines` | テキストのアウトライン化 |
 | `assign_color_profile` | カラープロファイルの割り当て（色値の変換は行わない） |
@@ -313,6 +333,7 @@ Claude Desktop のプロンプト一覧から選択できるワークフロー
 | `create_path_text` | パスに沿ったテキストの作成 |
 | `place_symbol` | シンボルインスタンスの配置・差し替え |
 | `select_objects` | UUID指定でオブジェクトを選択（複数選択対応） |
+| `create_crop_marks` | トンボ（トリムマーク）の作成。ロケールに応じた自動スタイル選択（日本式ダブルライン / 西洋式シングルライン） |
 | `place_style_guide` | アートボード外にビジュアルスタイルガイドを配置（カラー・フォント・スペーシング・マージン・ガイド間隔） |
 | `undo` | 操作の取り消し/やり直し（複数ステップ対応） |
 
@@ -339,10 +360,99 @@ Claude Desktop のプロンプト一覧から選択できるワークフロー
 |---|---|
 | `preflight_check` | 入稿前チェック（RGB 混在、リンク切れ、低解像度、白オーバープリント、透明+オーバープリント相互作用、PDF/X 適合等） |
 | `check_text_consistency` | テキスト整合性チェック（ダミーテキスト検出、表記揺れパターン検出、全テキスト一覧） |
-| `set_workflow` | ワークフロー設定（Web/Print モード切り替え、座標系デフォルト設定） |
+| `set_workflow` | ワークフロー設定（Web/Print モード切り替え、自動検出された座標系のオーバーライド） |
+
+</details>
+
+---
+
+## 座標系
+
+サーバーはドキュメントの設定から座標系を自動検出します：
+
+| ドキュメント種別 | 座標系 | 原点 | Y軸 |
+|---|---|---|---|
+| CMYK / 印刷 | `document` | 左下 | 上向き |
+| RGB / Web | `artboard-web` | アートボード左上 | 下向き |
+
+- **CMYK ドキュメント**では Illustrator ネイティブの座標系を使用。印刷デザイナーの感覚と一致します
+- **RGB ドキュメント**では Web スタイルの座標系を使用。AI が扱いやすい形式です
+- `set_workflow` で自動検出された座標系を手動でオーバーライドできます
+- すべてのツールレスポンスに `coordinateSystem` フィールドが含まれ、使用中の座標系を確認できます
+
+---
+
+## 作例: SMPTE テストパターン
+
+1920×1080 の SMPTE カラーバーテストパターンを、Claude への自然言語の指示だけで作成した例です。
+
+**プロンプト:**
+
+> 映像用の1920x1080のテストパターンつくって
+
+**出力結果:**
+
+<img src="docs/images/example-smpte-test-pattern.png" width="720" alt="Claude と illustrator-mcp-server で生成した SMPTE カラーバーテストパターン" />
+
+**アートボード構造** (`get_document_structure` の出力):
+
+<details>
+<summary>クリックで展開</summary>
+
+```
+Labels
+├── title-safe-label        (text)    — "TITLE SAFE (10%)"
+├── action-safe-label       (text)    — "ACTION SAFE (5%)"
+├── credit-label            (text)    — "Generated by illustrator-mcp-server"
+├── test-label              (text)    — "SMPTE COLOR BARS — TEST PATTERN"
+├── format-label            (text)    — "Full HD — 16:9"
+└── resolution-label        (text)    — "1920 x 1080"
+
+Center Cross
+├── title-safe              (path)    — 1536×864 タイトルセーフ枠
+├── action-safe             (path)    — 1728×972 アクションセーフ枠
+├── cross-circle            (path)    — 150×150 センターサークル
+├── cross-v                 (path)    — 垂直クロスヘア
+└── cross-h                 (path)    — 水平クロスヘア
+
+Color Bars
+├── pluge-black … pluge-navy   (path ×9)  — PLUGE / グレースケール下段
+├── rev-white … rev-blue       (path ×7)  — 補色バー中段
+└── bar-white … bar-blue       (path ×7)  — 75% SMPTE カラーバー
+```
 
 </details>
 
+> 使用ツール: `create_document`, `manage_layers`, `create_rectangle` ×23, `create_line` ×2, `create_ellipse`, `create_text_frame` ×6, `modify_object` ×4, `save_document`, `export`
+
+---
+
+## 作例: Twilight Geometry
+
+幾何学的な抽象風景画 — 「好きなアートを自由に作って」という指示だけで、Claude が構想から完成まですべて自律的に制作した作品です。
+
+**プロンプト:**
+
+> あなたが考えるアート作品を思いつくままにイラストレーターで作ってみて。時間はたっぷりある。好きなように作っていこう。
+
+**制作中の Claude の言葉:**
+
+> 「Twilight Geometry（幾何学の黄昏）」というタイトルで、幾何学的な抽象風景画を作ろうと思う。深い夜空のグラデーション背景に、幾何学的な山並み、月、星を配置する構成で。
+
+> ダイヤモンド型の星を5つ配置。微妙な色味の違い — 暖かい白、冷たい青、ラベンダーの紫 — で星の種類を表現。星座のような繊細な線で結び、ワイヤーフレームの三角形と六角形を空に浮かべて幻想的な雰囲気を強化。
+
+> 水面に月の光が揺らめく反射線を入れて、徐々に短くなる水平のきらめき線で遠近感を出す。
+
+**完成後の Claude の感想:**
+
+> 想像以上にいい雰囲気になった。幾何学と自然のハイブリッドな世界観が出せたと思う。
+
+**出力結果:**
+
+<img src="docs/images/example-twilight-geometry.png" width="720" alt="Twilight Geometry — Claude と illustrator-mcp-server で生成した幾何学的抽象風景画" />
+
+> 使用ツール: `create_document`, `manage_layers` ×4, `create_rectangle` ×2, `create_gradient` ×2, `create_path` ×11, `create_ellipse` ×14, `create_line` ×4, `create_text_frame` ×2, `modify_object`, `set_z_order`, `export`
+
 ---
 
 ## 既知の制約
@@ -414,7 +524,7 @@ npm test
 npx tsx test/e2e/smoke-test.ts
 ```
 
-E2E テストは新規ドキュメントを作成し、テストオブジェクトを配置して全 106 ケース（登録済み全ツールカバー）を 6 フェーズで自動実行します。
+E2E テストは新規ドキュメント（RGB + CMYK）を作成し、テストオブジェクトを配置して全 182 ケース（座標系の自動検出を含む登録済み全ツールカバー）を 10 フェーズで自動実行します。
 
 ---