AI插画MCP服务器

E2E smoke test (requires Illustrator running)

npx tsx test/e2e/smoke-test.ts ```

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.

---

Building from Source

git clone https://github.com/ie3jp/illustrator-mcp-server.git
cd illustrator-mcp-server
npm install
npm run build
claude mcp add illustrator-mcp -- node /path/to/illustrator-mcp-server/dist/index.js

🚀 Quick Start

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

---

🎨 Gallery

All artwork below was created entirely by Claude through natural language conversation — no manual Illustrator operation involved.

Event Poster	Logo Concepts
Business Card	Twilight Geometry

See detailed breakdowns 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!

---

Tool Reference

Workflow Templates

Pre-built workflow templates available in the Claude Desktop prompt picker.

---