illustrator-mcp-server 1.2.10 → 1.2.12

package/README.ja.md

@@ -9,55 +9,42 @@
 [![MCP](https://img.shields.io/badge/MCP-Compatible-purple.svg)](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/) サーバー。
+Adobe Illustrator のデザインデータを読み取り・操作・書き出しする [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) サーバー — 63 のツールを内蔵。
 
 Claude などの AI アシスタントから Illustrator を直接操作し、Web 実装に必要なデザイン情報の取得や、印刷用データの確認・書き出しを行えます。
 
 ---
 
-## クイックスタート
+> [!TIP]
+> このツールの開発・維持には費用がかかっています。
+> 役に立ったらぜひ応援お願いします — [☕ コーヒー奢ってください!](https://ko-fi.com/cyocun)
 
-**必要なもの:** macOS または Windows / Adobe Illustrator CC 2024+ / [Node.js 20+](https://nodejs.org/)
-
-<details>
-<summary><strong>Node.js のインストール方法（初めての方はこちら）</strong></summary>
-
-Node.js は、このツールを動かすために必要なソフトウェアです。
-すでにインストール済みの方はスキップしてください。
-
-1. [nodejs.org](https://nodejs.org/) を開く
-2. **「LTS」と書かれた緑色のボタン**をクリックしてダウンロード
-3. ダウンロードしたファイルを開き、画面の指示に従ってインストール
-
-インストールできたか確認するには、ターミナル（macOS）またはコマンドプロンプト（Windows）を開いて以下を入力します:
-
-```bash
-node -v
-```
+---
 
-`v20.x.x` のようにバージョン番号が表示されれば OK です。
+## 🚀 クイックスタート
 
-</details>
+### 🛠️ Claude Code
 
-### Claude Code
+[Node.js 20+](https://nodejs.org/) が必要です。
 
 ```bash
 claude mcp add illustrator-mcp -- npx illustrator-mcp-server
 ```
 
-### Claude Desktop
+### 🖥️ Claude Desktop
 
-1. [GitHub Releases](https://github.com/ie3jp/illustrator-mcp-server/releases/latest) から **`illustrator-mcp-server-x.x.x.mcpb`** をダウンロード
+1. [GitHub Releases](https://github.com/ie3jp/illustrator-mcp-server/releases/latest) から **`illustrator-mcp-server.mcpb`** をダウンロード
 2. Claude Desktop を開き、**設定** → **拡張機能** を開く
 3. ダウンロードした `.mcpb` ファイルを拡張機能パネルにドラッグ＆ドロップ
 4. **インストール** ボタンをクリック
 
-> **更新について:** `.mcpb` 拡張機能は自動更新されません。更新するには新しいバージョンをダウンロードして再インストールしてください。自動更新が必要な場合は、下記の npx 方式をお使いください。
-
 <details>
 <summary><strong>別の方法: 手動設定（npx 経由で常に最新版）</strong></summary>
 
-設定ファイルを開いて、接続情報を書き込みます。
+> [!NOTE]
+> `.mcpb` 拡張機能は自動更新されません。更新するには新しいバージョンをダウンロードして再インストールしてください。自動更新が必要な場合は、下記の npx 方式をお使いください。
+
+[Node.js 20+](https://nodejs.org/) が必要です。設定ファイルを開いて、接続情報を書き込みます。
 
 #### 1. 設定ファイルを開く
 
@@ -78,7 +65,8 @@ Claude Desktop のメニューバーから:
 }
 ```
 
-> **注意:** nvm / mise / fnm 等のバージョンマネージャで Node.js をインストールした場合、Claude Desktop が `npx` を見つけられないことがあります。その場合はフルパスを指定してください:
+> [!NOTE]
+> nvm / mise / fnm 等のバージョンマネージャで Node.js をインストールした場合、Claude Desktop が `npx` を見つけられないことがあります。その場合はフルパスを指定してください:
 > ```json
 > "command": "/フルパス/npx"
 > ```
@@ -91,14 +79,18 @@ Claude Desktop のメニューバーから:
 
 </details>
 
+> [!CAUTION]
+> AI は間違えることがあります。出力を過信せず、**入稿データの最終確認は必ず人間が行ってください**。結果についての責任は利用者にあります。
 
+> [!NOTE]
 > **macOS:** 初回実行時にオートメーション権限ダイアログが表示されます。システム設定 > プライバシーとセキュリティ > オートメーション で許可してください。
 
-> **Note:** 操作系・書き出し系ツールの実行時、Illustrator がフォアグラウンドに切り替わります。
+> [!NOTE]
+> 操作系・書き出し系ツールの実行時、Illustrator がフォアグラウンドに切り替わります。
 
 ---
 
-## こんなことができます
+## 🎬 こんなことができます
 
 ```
 あなた: このドキュメントのテキスト情報を全部教えて
@@ -133,9 +125,7 @@ Claude:  → get_document_info → resize_for_variation
 
 ---
 
-## 使い方レシピ集
-
-### Web 実装
+## 📖 使い方レシピ集
 
 <details>
 <summary><b>デザインカンプから CSS 用の色・フォント情報を抜き出したい</b></summary>
@@ -176,27 +166,6 @@ Claude:  → get_artboards → convert_to_outlines → export (繰り返し)
 
 </details>
 
-<details>
-<summary><b>特定のオブジェクトのスタイル情報を知りたい</b></summary>
-
-```
-あなた: 「CTA ボタン」という名前のオブジェクトの情報を教えて
-
-Claude:  → find_objects (name: "CTA ボタン") → get_path_items → get_effects
-
-         ■ CTA ボタン (uuid: abc-123)
-         - サイズ: 200×48px
-         - 角丸: 24px
-         - 塗り: #1A73E8
-         - 線: なし
-         - 不透明度: 100%
-         - ドロップシャドウ: あり（パラメータは API 制限のため取得不可）
-```
-
-</details>
-
-### 印刷・入稿
-
 <details>
 <summary><b>入稿データを PDF/X-1a 準拠でチェックしたい</b></summary>
 
@@ -212,66 +181,6 @@ Claude:  → preflight_check (target_pdf_profile: "x1a")
          ⚠ 警告:
          - 非アウトラインフォント 5 個（埋め込み推奨）
          - 画像 "photo_02.jpg" が 150dpi（300dpi 以上推奨）
-
-         → 透明を分割統合し、RGB をCMYK に変換してから再チェックしてください。
-```
-
-</details>
-
-<details>
-<summary><b>オーバープリントの設定を確認して事故を防ぎたい</b></summary>
-
-```
-あなた: オーバープリントの状態を確認して
-
-Claude:  → get_overprint_info
-
-         ■ オーバープリント検出: 4 オブジェクト
-
-         ✅ 安全 (K100 オーバープリント — 意図的):
-         - テキスト枠 "見出し" (K100, インク総量 100%)
-         - パス "罫線" (K100, インク総量 100%)
-
-         ⚠ 要確認 (事故の可能性):
-         - パス "背景装飾" (C30 M80 Y0 K0, インク総量 110%)
-           → カラーオブジェクトのオーバープリントは意図的ですか？
-         - パス "リッチブラック枠" (C40 M40 Y40 K100, インク総量 320%)
-           → リッチブラック + オーバープリントは予期しない色被りの原因になります
-```
-
-</details>
-
-<details>
-<summary><b>色分解（版情報）を確認したい</b></summary>
-
-```
-あなた: このドキュメントの色分解情報を教えて
-
-Claude:  → get_separation_info
-
-         ■ 色分解情報 (CMYK ドキュメント)
-         - Cyan: 使用箇所 342
-         - Magenta: 使用箇所 287
-         - Yellow: 使用箇所 301
-         - Black: 使用箇所 456
-         - DIC 2585 (スポットカラー): 使用箇所 12
-           → 5 版での出力になります。スポットカラーが意図的か確認してください。
-```
-
-</details>
-
-<details>
-<summary><b>印刷用 PDF をトンボ付きで書き出したい</b></summary>
-
-```
-あなた: 日本式トンボ付き、裁ち落とし3mm で PDF 書き出して
-
-Claude:  → export_pdf (trim_marks: true, marks_style: "japanese", bleed: true)
-
-         /output/print_ready.pdf に書き出しました。
-         - 日本式トンボ (0.125pt)
-         - 裁ち落とし 3mm
-         - レジストレーションマーク自動付与
 ```
 
 </details>
@@ -293,140 +202,6 @@ Claude:  → get_images (include_print_info: true)
 
 </details>
 
-### テキスト校正
-
-<details>
-<summary><b>テキストの表記揺れやダミーテキストの消し忘れを見つけたい</b></summary>
-
-```
-あなた: テキストの表記揺れをチェックして
-
-Claude:  → check_text_consistency
-
-         📝 表記揺れレポート:
-
-         ■ 表記揺れ（同じ意味で異なる表記）
-         ⚠ "お問い合わせ" (2箇所) vs "お問合せ" (1箇所)
-         ⚠ "ウェブサイト" (1箇所) vs "Webサイト" (3箇所) vs "WEBサイト" (1箇所)
-         ⚠ "〜" (2箇所) vs "～" (1箇所)  ← 波ダッシュ vs 全角チルダ
-         ⚠ "サーバー" (3箇所) vs "サーバ" (1箇所)
-
-         ■ 差し替え漏れの可能性
-         ❌ ヘッダーに "2024年度" が残っています（他は全て "2025年度"）
-         ❌ フッターの電話番号が "03-XXXX-1234"（他のページは "03-XXXX-5678"）
-
-         ■ ダミーテキストの残存
-         ❌ "テキストが入ります" (2箇所) — 仮テキストの消し忘れ？
-         ❌ "Lorem ipsum" (1箇所)
-```
-
-</details>
-
-### デザイン展開
-
-<details>
-<summary><b>チラシやバナーのサイズ違い展開を一括で作りたい</b></summary>
-
-```
-あなた: この A4 チラシから Web バナー 3 サイズ作って
-
-Claude:  → get_document_info → resize_for_variation (3 targets)
-
-         3 つのバリエーションを作成しました:
-         - アートボード "Leaderboard" (728×90pt, 縮小率 11%)
-         - アートボード "Medium Rectangle" (300×250pt, 縮小率 30%)
-         - アートボード "Wide Skyscraper" (160×600pt, 縮小率 71%)
-
-         ⚠ テキストのリフローは行っていません。
-           はみ出しや文字サイズの調整が必要な場合があります。
-```
-
-</details>
-
-<details>
-<summary><b>レイアウト用の図形やテキストをまとめて配置したい</b></summary>
-
-```
-あなた: 名刺のレイアウトを作って。社名、名前、メールアドレス、電話番号
-
-Claude:  → create_document (91×55mm, CMYK)
-         → create_text_frame × 4
-         → create_rectangle (背景)
-         → create_line (区切り線)
-
-         名刺レイアウトを作成しました:
-         - 社名: 上部中央 / Noto Sans JP Bold 9pt
-         - 氏名: 中央 / Noto Sans JP Bold 14pt
-         - メール: 下部 / Noto Sans JP Regular 7pt
-         - 電話: 下部 / Noto Sans JP Regular 7pt
-```
-
-</details>
-
-### オブジェクト操作
-
-<details>
-<summary><b>複数オブジェクトを整列・等間隔分布したい</b></summary>
-
-```
-あなた: ボタン3つを左揃えにして、縦に等間隔で並べて
-
-Claude:  → find_objects → align_objects (alignment: "left", distribute: "vertical")
-
-         3 オブジェクトを左揃え + 縦等間隔分布しました。
-```
-
-</details>
-
-<details>
-<summary><b>ブランドカラーを一括で差し替えたい</b></summary>
-
-```
-あなた: 赤 (C0 M100 Y100 K0) を全部、新しいブランドカラー (C80 M10 Y0 K0) に変えて
-
-Claude:  → replace_color (from: cmyk 0,100,100,0 → to: cmyk 80,10,0,0)
-
-         塗り 24 箇所 / 線 3 箇所を置換しました。
-```
-
-</details>
-
-<details>
-<summary><b>使用カラーの一覧をカラーチップとして配置したい</b></summary>
-
-```
-あなた: 使ってる色をアートボードの右にカラーチップとして並べて
-
-Claude:  → place_color_chips (position: "right")
-
-         12 色のカラーチップを "Color Chips" レイヤーに配置しました。
-         各チップに CMYK 値のラベル付き。
-```
-
-</details>
-
-### カラー管理
-
-<details>
-<summary><b>CMYK ドキュメントに RGB が混在していないか調べたい</b></summary>
-
-```
-あなた: カラーの問題を診断して
-
-Claude:  → get_colors (include_diagnostics: true)
-
-         ■ カラー診断 (CMYK ドキュメント)
-         ❌ RGB カラー混在: 塗り 3 箇所 / 線 1 箇所
-         ⚠ グラデーション警告:
-           - "Rainbow gradient": ストップ #2 が RGB
-         ■ インク総量が高い色:
-           - C80 M70 Y70 K90 (総量 310%) — 紙面によってはインク過多
-```
-
-</details>
-
-### アクセシビリティ
-
 <details>
 <summary><b>テキストと背景のコントラスト比を WCAG 基準でチェックしたい</b></summary>
 
@@ -443,73 +218,19 @@ Claude:  → check_contrast (auto_detect: true)
 
 </details>
 
-### デザインシステム連携
-
-<details>
-<summary><b>デザインカンプからデザイントークンを抽出したい</b></summary>
-
-```
-あなた: CSS カスタムプロパティとしてデザイントークンを抽出して
-
-Claude:  → extract_design_tokens (format: "css")
-
-         :root {
-           --color-primary: #1A73E8;
-           --color-secondary: #34A853;
-           --color-tertiary: #FBBC04;
-
-           --font-heading-family: "NotoSansJP-Bold";
-           --font-heading-size: 32pt;
-           --font-body-family: "NotoSansJP-Regular";
-           --font-body-size: 16pt;
-
-           --spacing-8: 8pt;
-           --spacing-16: 16pt;
-           --spacing-24: 24pt;
-         }
-```
-
-</details>
+---
 
-## MCP Prompts
+## ワークフローテンプレート
 
-ワークフロー全体を Claude に指示するプロンプトテンプレート。Claude Desktop のプロンプト一覧から選択できます。
+Claude Desktop のプロンプト一覧から選択できるワークフローテンプレートです。
 
-| Prompt | 概要 |
-|--------|------|
+| テンプレート | 概要 |
+|-------------|------|
 | `quick-layout` | テキスト原稿を渡すと、見出し・本文・キャプションを推測してアートボード上にざっくり配置 |
 | `print-preflight-workflow` | 印刷入稿前の7ステップ包括チェック（ドキュメント情報→プリフライト→オーバープリント→色分解→画像→カラー→テキスト） |
 
 ---
 
-## Claude Code Skills
-
-MCP ツールを組み合わせたワークフローを、スラッシュコマンドとして Claude Code に追加できます。
-
-### 入稿前プリフライトチェック (`/illustrator-preflight`)
-
-`preflight_check` + `get_overprint_info` + `check_text_consistency` を並列実行し、結果を重要度別（Critical / Warning / Info）に統合レポートします。印刷事故につながる問題を見落としなくチェックできます。
-
-**インストール:**
-
-```bash
-/plugin install illustrator-preflight
-```
-
-**使い方:**
-
-Claude Code で `/illustrator-preflight:illustrator-preflight` と入力するか、「入稿前チェックして」と依頼してください。
-
----
-
-## 特徴
-
-- **63 ツール + 2 Prompts** — 読み取り 21 / 操作 37 / 書き出し 2 / ユーティリティ 3
-- **Web 座標系** — デフォルトでアートボード相対・Y 軸下向き正（CSS/SVG と同じ座標系）
-- **UUID トラッキング** — 全オブジェクトを `pageItem.note` の UUID で一意に識別
-
----
-
 ## ツール一覧
 
 ### 読み取り系 (21)
@@ -592,48 +313,72 @@ Claude Code で `/illustrator-preflight:illustrator-preflight` と入力する
 
 ### 書き出し系 (2)
 
+<details>
+<summary>クリックして展開</summary>
+
 | ツール | 概要 |
 |---|---|
 | `export` | SVG / PNG / JPG 書き出し（アートボード、選択範囲、UUID 指定） |
 | `export_pdf` | 印刷用 PDF 書き出し（トンボ、裁ち落とし、選択的ダウンサンプリング、出力インテント） |
 
+</details>
+
 ### ユーティリティ (3)
 
+<details>
+<summary>クリックして展開</summary>
+
 | ツール | 概要 |
 |---|---|
 | `preflight_check` | 入稿前チェック（RGB 混在、リンク切れ、低解像度、白オーバープリント、透明+オーバープリント相互作用、PDF/X 適合等） |
 | `check_text_consistency` | テキスト整合性チェック（ダミーテキスト検出、表記揺れパターン検出、全テキスト一覧） |
 | `set_workflow` | ワークフロー設定（Web/Print モード切り替え、座標系デフォルト設定） |
 
+</details>
+
+---
+
+## 既知の制約
+
+| 制約 | 詳細 |
+|---|---|
+| Windows 対応 | Windows は PowerShell COM を使用（実機未検証） |
+| ライブエフェクト | ドロップシャドウ等のエフェクトは存在の検出はできますが、パラメータの取得はできません |
+| カラープロファイル | プロファイルの割り当てのみ対応。完全な変換はできません |
+| 裁ち落とし設定 | 裁ち落とし設定の読み取りはできません（Illustrator API の制限） |
+| WebP 書き出し | 非対応です（PNG / SVG をお使いください） |
+| 日本式トンボ | PDF 書き出し時に正しく反映されない場合があります |
+| フォント埋め込み | 埋め込み方式（完全/サブセット）の制御はできません。PDF プリセットで設定してください |
+| サイズ展開 | 比例縮小のみ。テキストのはみ出し等は手動での調整が必要です |
+
 ---
 
+<br>
+
+# 開発者向け情報
+
 ## アーキテクチャ
 
 ```mermaid
 flowchart LR
     Claude <-->|MCP Protocol| Server["MCP Server\n(TypeScript/Node.js)"]
-    Server <-->|"execFile (macOS)"| osascript
-    Server <-->|"execFile (Windows)"| PS["powershell.exe\n(COM Automation)"]
-    osascript <-->|do javascript| AI["Adobe Illustrator\n(ExtendScript/JSX)"]
-    PS <-->|DoJavaScript| AI
 
+    Server -.->|generate| Runner["run-{uuid}.scpt / .ps1"]
+    Server -.->|generate| JSX["script-{uuid}.jsx\n(BOM UTF-8)"]
     Server -.->|write| PF["params-{uuid}.json"]
+
+    Runner -->|execFile| osascript
+    Runner -->|execFile| PS["powershell.exe"]
+
+    osascript -->|do javascript| AI["Adobe Illustrator\n(ExtendScript/JSX)"]
+    PS -->|DoJavaScript| AI
+
+    JSX -.->|execute| AI
     PF -.->|read| AI
     AI -.->|write| RF["result-{uuid}.json"]
     RF -.->|read| Server
-    Server -.->|generate| JSX["script-{uuid}.jsx\n(BOM UTF-8)"]
-    Server -.->|generate| Runner["run-{uuid}.scpt / .ps1"]
 ```
 
-### 座標系
-
-座標を扱う read / modify ツールでは `coordinate_system` パラメータを受け付けます。export やドキュメント全体に対する utility ツールは、座標変換に依存しないため受け付けません。
-
-| 値 | 原点 | Y 軸 | 用途 |
-|---|---|---|---|
-| `artboard-web`（デフォルト） | アートボード左上 | 下向き正 | Web/CSS 実装 |
-| `document` | ペーストボード | 上向き正（Illustrator ネイティブ） | 印刷・DTP |
-
 ---
 
 ## ソースからビルド
@@ -666,27 +411,6 @@ E2E テストは新規ドキュメントを作成し、テストオブジェク
 
 ---
 
-## 既知の制約
-
-| 制約 | 詳細 |
-|---|---|
-| macOS / Windows | macOS は osascript、Windows は PowerShell COM を使用（Windows は実機未検証） |
-| ライブエフェクト | ExtendScript DOM の制約により、ドロップシャドウ等のパラメータ取得不可 |
-| カラープロファイル変換 | プロファイル割り当てのみ。完全な ICC 変換は非対応 |
-| 裁ち落とし設定 | ExtendScript API で非公開のため取得不可 |
-| WebP 書き出し | ExtendScript の ExportType に存在しないため非対応 |
-| 日本式トンボ | `PageMarksTypes.Japanese` が PDF 書き出しで反映されない場合あり |
-| フォント埋め込み制御 | PDF 書き出し時のフォント埋め込み方式 (full/subset) は API 非公開。PDF プリセットで設定 |
-| サイズ展開 | テキストリフロー非対応。比例配置のみ（スマートレイアウトではない） |
-
----
-
-## サポート
-
-このツールの開発・維持には費用がかかっています。役に立ったらぜひ応援お願いします — [コーヒー奢ってください ☕](https://ko-fi.com/cyocun)
-
----
-
 ## ライセンス
 
 [MIT](LICENSE)