illustrator-mcp-server 1.3.2 → 1.5.0

package/README.md

@@ -1,12 +1,12 @@
-**[日本語版はこちら / Japanese version](README.ja.md)**
+**🇺🇸 English** | [🇯🇵 日本語](README.ja.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)
 
 An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server for reading, manipulating, and exporting Adobe Illustrator design data — with 63 built-in tools.
@@ -17,6 +17,25 @@ Control Illustrator directly from AI assistants like Claude — extract design i
 
 ---
 
+## 🎨 Gallery
+
+All artwork below was created entirely by Claude through natural language conversation — no manual Illustrator operation involved.
+
+<table>
+<tr>
+<td align="center"><img src="docs/images/example-event-poster.png" width="300" alt="Event poster — SYNC TOKYO 2026" /><br><b>Event Poster</b></td>
+<td align="center"><img src="docs/images/example-logo-concepts.png" width="300" alt="Logo concepts — Slow Drip Coffee Co." /><br><b>Logo Concepts</b></td>
+</tr>
+<tr>
+<td align="center"><img src="docs/images/example-business-card.png" width="300" alt="Business card — KUMO Studio" /><br><b>Business Card</b></td>
+<td align="center"><img src="docs/images/example-twilight-geometry.png" width="300" alt="Twilight Geometry — abstract geometric landscape" /><br><b>Twilight Geometry</b></td>
+</tr>
+</table>
+
+> See [detailed breakdowns](#example-smpte-test-pattern) below for prompts, tool usage, and artboard structure.
+
+---
+
 > [!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)
@@ -272,7 +291,7 @@ Pre-built workflow templates available in the Claude Desktop prompt picker.
 
 </details>
 
-### Modify Tools (38)
+### Modify Tools (39)
 
 <details>
 <summary>Click to expand</summary>
@@ -284,7 +303,8 @@ Pre-built workflow templates available in the Claude Desktop prompt picker.
 | `create_line` | Create a line |
 | `create_text_frame` | Create a text frame (point or area type) |
 | `create_path` | Create a custom path (with Bezier handles) |
-| `place_image` | Place an image file as linked or embedded |
+| `place_image` | Place a raster/PDF image file as linked or embedded (SVG is rejected — use `import_svg_as_editable`) |
+| `import_svg_as_editable` | Import an SVG file as editable Illustrator paths/text/groups (not as a linked image) |
 | `modify_object` | Modify properties of an existing object |
 | `convert_to_outlines` | Convert text to outlines |
 | `assign_color_profile` | Assign (tag) a color profile (does not convert color values) |
@@ -341,12 +361,101 @@ Pre-built workflow templates available in the Claude Desktop prompt picker.
 |---|---|
 | `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 |
+| `set_workflow` | Set workflow mode (web/print) to override auto-detected coordinate system |
 
 </details>
 
 ---
 
+## Coordinate System
+
+The server automatically detects the coordinate system from the document:
+
+| Document type | Coordinate system | Origin | Y axis |
+|---|---|---|---|
+| CMYK / Print | `document` | Bottom-left | Up |
+| RGB / Web | `artboard-web` | Top-left of artboard | Down |
+
+- **CMYK documents** use Illustrator's native coordinate system, matching what print designers expect
+- **RGB documents** use a web-style coordinate system that is easier for AI to work with
+- Use `set_workflow` to override the auto-detected coordinate system if needed
+- All tool responses include a `coordinateSystem` field indicating which system is active
+
+---
+
+## Example: SMPTE Test Pattern
+
+A 1920×1080 SMPTE color bar test pattern, created entirely through natural language instructions to Claude.
+
+**Prompt:**
+
+> Make a 1920x1080 video test pattern
+
+**Result:**
+
+<img src="docs/images/example-smpte-test-pattern.png" width="720" alt="SMPTE color bar test pattern generated by Claude via illustrator-mcp-server" />
+
+**Artboard structure** (via `get_document_structure`):
+
+<details>
+<summary>Click to expand</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 stroke rectangle
+├── action-safe             (path)    — 1728×972 stroke rectangle
+├── cross-circle            (path)    — 150×150 center circle
+├── cross-v                 (path)    — vertical crosshair
+└── cross-h                 (path)    — horizontal crosshair
+
+Color Bars
+├── pluge-black … pluge-navy   (path ×9)  — PLUGE / grayscale bottom strip
+├── rev-white … rev-blue       (path ×7)  — reverse color middle strip
+└── bar-white … bar-blue       (path ×7)  — 75% SMPTE color bars
+```
+
+</details>
+
+> Tools used: `create_document`, `manage_layers`, `create_rectangle` ×23, `create_line` ×2, `create_ellipse`, `create_text_frame` ×6, `modify_object` ×4, `save_document`, `export`
+
+---
+
+## Example: Twilight Geometry
+
+An abstract geometric landscape artwork — created entirely by Claude, with no human design direction beyond "make whatever art you want."
+
+**Prompt:**
+
+> Make an art piece of your own imagination in Illustrator. Take your time. Create whatever you like.
+
+**Claude's process:**
+
+> I'll create "Twilight Geometry" — an abstract landscape with geometric celestial elements. A deep gradient twilight sky, layered mountain silhouettes, a crescent moon with decorative rings, and stars scattered across the canvas.
+
+> Diamond-shaped stars in different colors — warm whites, cool blues, lavender purples — each one subtly different to suggest different types of stars. Constellation lines connecting them. Wireframe triangles and a hexagon floating in the sky for a mystical atmosphere.
+
+> A water surface at the bottom with the moon's light reflected as shimmering wavy lines, fading as they descend.
+
+**Claude's reflection:**
+
+> It turned out better than I expected. I think the hybrid world of geometry and nature came through well.
+
+**Result:**
+
+<img src="docs/images/example-twilight-geometry.png" width="720" alt="Twilight Geometry — abstract geometric landscape art generated by Claude via illustrator-mcp-server" />
+
+> Tools used: `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`
+
+---
+
 ## Known Limitations
 
 | Limitation | Details |
@@ -416,7 +525,7 @@ npm test
 npx tsx test/e2e/smoke-test.ts
 ```
 
-The E2E test creates a fresh document, places test objects, runs 106 test cases across 6 phases covering all registered tools, and cleans up automatically.
+The E2E test creates fresh documents (RGB + CMYK), places test objects, runs 182 test cases across 10 phases covering all registered tools and coordinate system auto-detection, and cleans up automatically.
 
 ---