illustrator-mcp-server 1.2.11 → 1.3.0

package/README.md

@@ -1,5 +1,3 @@
-> **⚠️ Caution:** AI can make mistakes. Do not over-rely on the output — **always have a human perform the final check on submission data**. The user is responsible for the results.
-
 **[日本語版はこちら / Japanese version](README.ja.md)**
 
 # Illustrator MCP Server
@@ -11,7 +9,7 @@
 [![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)
 
-An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server for reading, manipulating, and exporting Adobe Illustrator design data.
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server for reading, manipulating, and exporting Adobe Illustrator design data — with 63 built-in tools.
 
 Control Illustrator directly from AI assistants like Claude — extract design information for web implementation, verify print-ready data, and export assets.
 
@@ -19,53 +17,36 @@ Control Illustrator directly from AI assistants like Claude — extract design i
 
 ---
 
-> **☕ Support:** Developing and maintaining this tool takes time and resources. If it helps your workflow, your support means a lot — [buy me a coffee!](https://ko-fi.com/cyocun)
+> [!TIP]
+> Developing and maintaining this tool takes time and resources.
+> If it helps your workflow, your support means a lot — [☕ buy me a coffee!](https://ko-fi.com/cyocun)
 
 ---
 
 ## 🚀 Quick Start
 
-**Requirements:** macOS or Windows / Adobe Illustrator CC 2024+ / [Node.js 20+](https://nodejs.org/)
-
-<details>
-<summary><strong>How to install Node.js (first-time setup)</strong></summary>
-
-Node.js is a runtime required to run this tool.
-Skip this section if you already have it installed.
-
-1. Go to [nodejs.org](https://nodejs.org/)
-2. Click the **green "LTS" button** to download
-3. Open the downloaded file and follow the installer instructions
-
-To verify the installation, open Terminal (macOS) or Command Prompt (Windows) and type:
-
-```bash
-node -v
-```
-
-If you see a version number like `v20.x.x`, you're all set.
-
-</details>
+### 🛠️ Claude Code
 
-### Claude Code
+Requires [Node.js 20+](https://nodejs.org/).
 
 ```bash
 claude mcp add illustrator-mcp -- npx illustrator-mcp-server
 ```
 
-### Claude Desktop
+### 🖥️ Claude Desktop
 
-1. Download **`illustrator-mcp-server-x.x.x.mcpb`** from [GitHub Releases](https://github.com/ie3jp/illustrator-mcp-server/releases/latest)
+1. Download **`illustrator-mcp-server.mcpb`** from [GitHub Releases](https://github.com/ie3jp/illustrator-mcp-server/releases/latest)
 2. Open Claude Desktop → **Settings** → **Extensions**
 3. Drag and drop the `.mcpb` file into the Extensions panel
 4. Click the **Install** button
 
-> **Updating:** The `.mcpb` extension does not auto-update. To update, download the new version and reinstall. If you prefer automatic updates, use the npx method below instead.
-
 <details>
 <summary><strong>Alternative: manual config (always up to date via npx)</strong></summary>
 
-Open the config file and add the connection settings.
+> [!NOTE]
+> The `.mcpb` extension does not auto-update. To update, download the new version and reinstall. If you prefer automatic updates, use the npx method below instead.
+
+Requires [Node.js 20+](https://nodejs.org/). Open the config file and add the connection settings.
 
 #### 1. Open the config file
 
@@ -86,7 +67,8 @@ From the Claude Desktop menu bar:
 }
 ```
 
-> **Note:** If you installed Node.js via a version manager (nvm, mise, fnm, etc.), Claude Desktop may not find `npx`. In that case, use the full path:
+> [!NOTE]
+> If you installed Node.js via a version manager (nvm, mise, fnm, etc.), Claude Desktop may not find `npx`. In that case, use the full path:
 > ```json
 > "command": "/full/path/to/npx"
 > ```
@@ -99,9 +81,14 @@ From the Claude Desktop menu bar:
 
 </details>
 
+> [!CAUTION]
+> AI can make mistakes. Do not over-rely on the output — **always have a human perform the final check on submission data**. The user is responsible for the results.
+
+> [!NOTE]
 > **macOS:** On first run, allow automation access in System Settings > Privacy & Security > Automation.
 
-> **Note:** Modify and export tools will bring Illustrator to the foreground during execution.
+> [!NOTE]
+> Modify and export tools will bring Illustrator to the foreground during execution.
 
 ---
 
@@ -141,8 +128,6 @@ Claude:  → get_document_info → resize_for_variation
 
 ## 📖 Recipes
 
-### Web Implementation
-
 <details>
 <summary><b>Extract colors and fonts for CSS</b></summary>
 
@@ -182,27 +167,6 @@ Claude:  → get_artboards → convert_to_outlines → export (repeated)
 
 </details>
 
-<details>
-<summary><b>Inspect a specific object's styling</b></summary>
-
-```
-You:    Tell me about the "CTA Button" object
-
-Claude:  → find_objects (name: "CTA Button") → get_path_items → get_effects
-
-         ■ CTA Button (uuid: abc-123)
-         - Size: 200×48px
-         - Corner radius: 24px
-         - Fill: #1A73E8
-         - Stroke: none
-         - Opacity: 100%
-         - Drop shadow: present (parameters not readable due to API limitation)
-```
-
-</details>
-
-### Print & Pre-press
-
 <details>
 <summary><b>Check PDF/X-1a compliance before submission</b></summary>
 
@@ -222,63 +186,6 @@ Claude:  → preflight_check (target_pdf_profile: "x1a")
 
 </details>
 
-<details>
-<summary><b>Audit overprint settings to prevent print accidents</b></summary>
-
-```
-You:    Check overprint settings
-
-Claude:  → get_overprint_info
-
-         ■ 4 objects with overprint
-
-         ✅ Safe (K100 overprint — intentional):
-         - "Headline" text (K100, ink coverage 100%)
-         - "Rule line" path (K100, ink coverage 100%)
-
-         ⚠ Review needed (possibly accidental):
-         - "Background decoration" (C30 M80 Y0 K0, coverage 110%)
-         - "Rich black frame" (C40 M40 Y40 K100, coverage 320%)
-           → Rich black + overprint can cause unexpected color bleed
-```
-
-</details>
-
-<details>
-<summary><b>Check color separations</b></summary>
-
-```
-You:    Show me the color separation info
-
-Claude:  → get_separation_info
-
-         ■ Separations (CMYK document)
-         - Cyan: 342 uses
-         - Magenta: 287 uses
-         - Yellow: 301 uses
-         - Black: 456 uses
-         - DIC 2585 (spot): 12 uses
-           → This will output as 5 plates.
-```
-
-</details>
-
-<details>
-<summary><b>Export PDF with crop marks and bleed</b></summary>
-
-```
-You:    Export PDF with Japanese crop marks and 3mm bleed
-
-Claude:  → export_pdf (trim_marks: true, marks_style: "japanese", bleed: true)
-
-         Exported to /output/print_ready.pdf
-         - Japanese crop marks (0.125pt)
-         - 3mm bleed
-         - Registration marks auto-applied
-```
-
-</details>
-
 <details>
 <summary><b>Check image quality for print</b></summary>
 
@@ -296,137 +203,6 @@ Claude:  → get_images (include_print_info: true)
 
 </details>
 
-### Text Proofing
-
-<details>
-<summary><b>Find placeholder text and notation inconsistencies</b></summary>
-
-```
-You:    Check text for inconsistencies
-
-Claude:  → check_text_consistency
-
-         📝 Consistency Report:
-
-         ■ Notation variations
-         ⚠ "Contact Us" (2 places) vs "Contact us" (1 place)
-         ⚠ "e-mail" (1 place) vs "email" (3 places) vs "E-mail" (1 place)
-
-         ■ Possible outdated content
-         ❌ Header still says "2024" (all other instances are "2025")
-         ❌ Footer phone number differs from other pages
-
-         ■ Placeholder text
-         ❌ "Lorem ipsum" (2 places) — forgotten placeholder?
-         ❌ "Sample text" (1 place)
-```
-
-</details>
-
-### Design Variations
-
-<details>
-<summary><b>Create multiple banner sizes from a single design</b></summary>
-
-```
-You:    Create 3 web banner sizes from this A4 flyer
-
-Claude:  → get_document_info → resize_for_variation (3 targets)
-
-         Created 3 variations:
-         - "Leaderboard" artboard (728×90pt, scaled to 11%)
-         - "Medium Rectangle" artboard (300×250pt, scaled to 30%)
-         - "Wide Skyscraper" artboard (160×600pt, scaled to 71%)
-
-         ⚠ Text reflow is not applied.
-           You may need to adjust text sizing and overflow manually.
-```
-
-</details>
-
-<details>
-<summary><b>Build a layout with shapes and text</b></summary>
-
-```
-You:    Create a business card layout with company name, name, email, and phone
-
-Claude:  → create_document (91×55mm, CMYK)
-         → create_text_frame × 4
-         → create_rectangle (background)
-         → create_line (divider)
-
-         Business card layout created:
-         - Company: top center / Noto Sans JP Bold 9pt
-         - Name: center / Noto Sans JP Bold 14pt
-         - Email: bottom / Noto Sans JP Regular 7pt
-         - Phone: bottom / Noto Sans JP Regular 7pt
-```
-
-</details>
-
-### Color Management
-
-<details>
-<summary><b>Diagnose color issues in a CMYK document</b></summary>
-
-```
-You:    Run a color diagnostic
-
-Claude:  → get_colors (include_diagnostics: true)
-
-         ■ Color Diagnostics (CMYK document)
-         ❌ RGB colors found: 3 fills / 1 stroke
-         ⚠ Gradient warning:
-           - "Rainbow gradient": stop #2 is RGB
-         ■ High ink coverage:
-           - C80 M70 Y70 K90 (total 310%) — may cause ink pooling
-```
-
-</details>
-
-### Object Operations
-
-<details>
-<summary><b>Align and distribute multiple objects</b></summary>
-
-```
-You:    Align these 3 buttons to the left and distribute vertically
-
-Claude:  → find_objects → align_objects (alignment: "left", distribute: "vertical")
-
-         Aligned 3 objects: left-aligned + vertically distributed.
-```
-
-</details>
-
-<details>
-<summary><b>Replace brand colors across the document</b></summary>
-
-```
-You:    Replace all red (C0 M100 Y100 K0) with the new brand blue (C80 M10 Y0 K0)
-
-Claude:  → replace_color (from → to)
-
-         Replaced 24 fills and 3 strokes.
-```
-
-</details>
-
-<details>
-<summary><b>Place color chips outside the artboard</b></summary>
-
-```
-You:    Show all used colors as chips to the right of the artboard
-
-Claude:  → place_color_chips (position: "right")
-
-         Placed 12 color chips on "Color Chips" layer with CMYK labels.
-```
-
-</details>
-
-### Accessibility
-
 <details>
 <summary><b>Check WCAG color contrast ratios</b></summary>
 
@@ -443,73 +219,19 @@ Claude:  → check_contrast (auto_detect: true)
 
 </details>
 
-### Design System
-
-<details>
-<summary><b>Extract design tokens from a comp</b></summary>
-
-```
-You:    Extract design tokens as CSS custom properties
-
-Claude:  → extract_design_tokens (format: "css")
-
-         :root {
-           --color-primary: #1A73E8;
-           --color-secondary: #34A853;
-           --font-heading-family: "NotoSansJP-Bold";
-           --font-heading-size: 32pt;
-           --spacing-8: 8pt;
-           --spacing-16: 16pt;
-         }
-```
-
-</details>
-
 ---
 
-<br>
-
-# For Developers
-
-## MCP Prompts
+## Workflow Templates
 
-Workflow templates that guide Claude through multi-step tasks. Available in the Claude Desktop prompt picker.
+Pre-built workflow templates available in the Claude Desktop prompt picker.
 
-| Prompt | Description |
-|--------|-------------|
+| Template | Description |
+|----------|-------------|
 | `quick-layout` | Paste text content and Claude arranges it on the artboard as headings, body, and captions |
 | `print-preflight-workflow` | Comprehensive 7-step pre-press check (document → preflight → overprint → separations → images → colors → text) |
 
 ---
 
-## Claude Code Skills
-
-Add pre-built workflows as slash commands in Claude Code, combining multiple MCP tools into guided processes.
-
-### Pre-press Preflight Check (`/illustrator-preflight`)
-
-Runs `preflight_check` + `get_overprint_info` + `check_text_consistency` in parallel, then merges results into a unified report grouped by severity (Critical / Warning / Info). Catches print-critical issues that are easy to miss manually.
-
-**Install:**
-
-```bash
-/plugin install illustrator-preflight
-```
-
-**Usage:**
-
-Type `/illustrator-preflight:illustrator-preflight` in Claude Code, or just ask "run a preflight check".
-
----
-
-## Features
-
-- **63 tools + 2 prompts** — 21 read / 37 modify / 2 export / 3 utility
-- **Web coordinate system** — Y-axis down, artboard-relative (same as CSS/SVG)
-- **UUID tracking** — Stable object identification across tool calls
-
----
-
 ## Tool Reference
 
 ### Read Tools (21)
@@ -592,48 +314,72 @@ Type `/illustrator-preflight:illustrator-preflight` in Claude Code, or just ask
 
 ### Export Tools (2)
 
+<details>
+<summary>Click to expand</summary>
+
 | Tool | Description |
 |---|---|
 | `export` | SVG / PNG / JPG export (by artboard, selection, or UUID) |
 | `export_pdf` | Print-ready PDF export (crop marks, bleed, selective downsampling, output intent) |
 
+</details>
+
 ### Utility (3)
 
+<details>
+<summary>Click to expand</summary>
+
 | Tool | Description |
 |---|---|
 | `preflight_check` | Pre-press check (RGB mixing, broken links, low resolution, white overprint, transparency+overprint interaction, PDF/X compliance, etc.) |
 | `check_text_consistency` | Text consistency check (placeholder detection, notation variation patterns, full text listing for LLM analysis) |
 | `set_workflow` | Set workflow mode (web/print) to configure default coordinate system |
 
+</details>
+
 ---
 
+## Known Limitations
+
+| Limitation | Details |
+|---|---|
+| Windows support | Windows uses PowerShell COM automation (not yet tested on real hardware) |
+| Live effects | Drop shadow and other effect parameters can be detected but not read |
+| Color profiles | Color profile assignment only — full conversion is not available |
+| Bleed settings | Bleed settings cannot be read (Illustrator API limitation) |
+| WebP export | Not supported — use PNG or SVG instead |
+| Japanese crop marks | PDF export automatically uses the TrimMark command approach: generates marks as document paths, exports, then removes via undo |
+| Font embedding | Embedding mode (full/subset) cannot be controlled directly — use PDF presets |
+| Size variations | Proportional scaling only — text may need manual adjustment afterward |
+
+---
+
+<br>
+
+# For Developers
+
 ## Architecture
 
 ```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"]
 ```
 
-### Coordinate System
-
-Geometry-aware read and modify tools accept a `coordinate_system` parameter. Export and document-wide utility tools do not.
-
-| Value | Origin | Y-axis | Use case |
-|---|---|---|---|
-| `artboard-web` (default) | Artboard top-left | Positive downward | Web / CSS implementation |
-| `document` | Pasteboard | Positive upward (Illustrator native) | Print / DTP |
-
 ---
 
 ## Building from Source
@@ -666,18 +412,9 @@ The E2E test creates a fresh document, places test objects, runs 106 test cases
 
 ---
 
-## Known Limitations
+## Disclaimer
 
-| Limitation | Details |
-|---|---|
-| macOS / Windows | macOS uses osascript, Windows uses PowerShell COM automation (not yet tested on real hardware) |
-| Live effects | ExtendScript DOM limitations prevent reading parameters for drop shadows, etc. |
-| Color profile conversion | Only profile assignment is supported; full ICC conversion is not available |
-| Bleed settings | Not accessible via the ExtendScript API (undocumented) |
-| WebP export | Not supported — ExportType does not include WebP in ExtendScript |
-| Japanese crop marks | `PageMarksTypes.Japanese` may not be applied correctly in PDF export |
-| Font embedding control | PDF font embedding mode (full/subset) is not exposed in the API. Use PDF presets instead |
-| Size variations | No text reflow. Proportional placement only (not smart layout) |
+This tool automates many Illustrator operations, but AI can make mistakes. Extracted data, preflight results, and document modifications should always be reviewed by a person. **Do not rely on this tool as your sole quality check.** Use it as an assistant alongside your own manual verification, especially for print submissions and client deliverables. The authors are not responsible for any damages or losses arising from the use of this software or its outputs.
 
 ---