[đŸ‡ș🇾 English](README.md) | [đŸ‡ŻđŸ‡” æ—„æœŹèȘž](README.ja.md) | [🇹🇳 çź€äœ“äž­æ–‡](README.zh-CN.md) | [đŸ‡°đŸ‡· 한ꔭ얎](README.ko.md) | [đŸ‡Ș🇾 Español](README.es.md) | **đŸ‡©đŸ‡Ș Deutsch** | [đŸ‡«đŸ‡· 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?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) Ein [MCP-Server (Model Context Protocol)](https://modelcontextprotocol.io/) zum Auslesen, Bearbeiten und Exportieren von Adobe-Illustrator-Designdaten — mit 63 integrierten Werkzeugen. Steuere Illustrator direkt aus KI-Assistenten wie Claude — extrahiere Designinformationen fĂŒr die Webumsetzung, prĂŒfe druckfertige Daten und exportiere Assets. Alles, was Adobes offizieller Illustrator MCP (Beta) kann — und mehr. Siehe den [Vergleich](#-vergleich-mit-adobes-offiziellem-illustrator-mcp). [![illustrator mcp server MCP server](https://glama.ai/mcp/servers/ie3jp/illustrator-mcp-server/badges/card.svg)](https://glama.ai/mcp/servers/ie3jp/illustrator-mcp-server) --- ## 🎹 Galerie Alle unten gezeigten Artworks wurden vollstĂ€ndig von Claude durch natĂŒrlichsprachige Konversation erstellt — ohne manuelle Bedienung von Illustrator.
Event-Poster — SYNC TOKYO 2026
Event-Poster		 Logo-Konzepte — Slow Drip Coffee Co.
Logo-Konzepte
Visitenkarte — KUMO Studio
Visitenkarte		 Twilight Geometry — abstrakte geometrische Landschaft
Twilight Geometry
> Siehe [ausfĂŒhrliche AufschlĂŒsselungen](#beispiel-smpte-testbild) weiter unten fĂŒr Prompts, Tool-Einsatz und ZeichenflĂ€chen-Struktur. --- > [!TIP] > Die Entwicklung und Pflege dieses Tools kostet Zeit und Ressourcen. > Wenn es Dir im Arbeitsalltag hilft, bedeutet Deine UnterstĂŒtzung viel — [☕ spendier mir einen Kaffee!](https://ko-fi.com/cyocun) --- ## 🚀 Schnellstart ### đŸ› ïž Claude Code Erfordert [Node.js 20+](https://nodejs.org/). ```bash claude mcp add illustrator-mcp -- npx illustrator-mcp-server ``` ### đŸ–„ïž Claude Desktop 1. Lade **`illustrator-mcp-server.mcpb`** aus den [GitHub Releases](https://github.com/ie3jp/illustrator-mcp-server/releases/latest) herunter 2. Öffne Claude Desktop → **Settings** → **Extensions** 3. Ziehe die `.mcpb`-Datei per Drag & Drop in das Extensions-Panel 4. Klicke auf den Button **Install**
Alternative: manuelle Konfiguration (immer aktuell via npx) > [!NOTE] > Die `.mcpb`-Extension aktualisiert sich nicht automatisch. Lade zum Aktualisieren die neue Version herunter und installiere sie erneut. Wenn Du automatische Updates bevorzugst, verwende stattdessen die npx-Methode unten. Erfordert [Node.js 20+](https://nodejs.org/). Öffne die Konfigurationsdatei und fĂŒge die Verbindungseinstellungen hinzu. #### 1. Konfigurationsdatei öffnen Aus der Claude-Desktop-MenĂŒleiste: **Claude** → **Settings...** → **Developer** (in der linken Seitenleiste) → Klicke auf den Button **Edit Config** #### 2. Einstellungen hinzufĂŒgen ```json { "mcpServers": { "illustrator": { "command": "npx", "args": ["illustrator-mcp-server"] } } } ``` > [!NOTE] > Wenn Du Node.js ĂŒber einen Versionsmanager (nvm, mise, fnm usw.) installiert hast, findet Claude Desktop `npx` möglicherweise nicht. In diesem Fall gib den vollstĂ€ndigen Pfad an: > ```json > "command": "/full/path/to/npx" > ``` > FĂŒhre `which npx` im Terminal aus, um den Pfad zu ermitteln. #### 3. Speichern und neu starten 1. Speichere die Datei und schließe den Texteditor 2. **Beende Claude Desktop vollstĂ€ndig** (⌘Q / Ctrl+Q) und öffne es erneut
> [!CAUTION] > KI kann Fehler machen. Verlasse Dich nicht zu sehr auf die Ausgabe — **die finale Kontrolle der Abgabedaten muss immer ein Mensch durchfĂŒhren**. Die Nutzerin oder der Nutzer trĂ€gt die Verantwortung fĂŒr die Ergebnisse. > [!NOTE] > **macOS:** Erlaube beim ersten Start den Automatisierungszugriff unter Systemeinstellungen > Datenschutz & Sicherheit > Automation. > [!NOTE] > Werkzeuge zum Bearbeiten und Exportieren bringen Illustrator wĂ€hrend der AusfĂŒhrung in den Vordergrund. ### Mehrere Illustrator-Versionen Wenn Du mehrere Versionen von Illustrator installiert hast, kannst Du Claude im GesprĂ€ch mitteilen, welche Version verwendet werden soll. Sag einfach so etwas wie „Nutze Illustrator 2024" und das Werkzeug `set_illustrator_version` steuert diese Version an. **UnterstĂŒtzte Versionen:** Illustrator 2024 (v28) und neuer sind verifiziert. Illustrator 2020–2023 (v24–v27) sollten funktionieren – sĂ€mtliche von diesem Server genutzten ExtendScript-APIs existieren seit v24 –, sind aber **nicht verifiziert**. Die Werkzeuge geben auf diesen Versionen daher eine Warnung zurĂŒck. Versionen Ă€lter als 2020 (v24) werden abgelehnt. Wenn auf einer nicht verifizierten Version etwas nicht funktioniert, [erstelle bitte ein Issue](https://github.com/ie3jp/illustrator-mcp-server/issues). > [!NOTE] > Wenn Illustrator bereits lĂ€uft, verbindet sich der Server unabhĂ€ngig von der Versionseinstellung mit der laufenden Instanz. Die Version wird nur verwendet, um die korrekte Version zu starten, solange Illustrator noch nicht lĂ€uft. --- ## 🎬 Was Du tun kannst ``` Du: Zeig mir alle Textinformationen in diesem Dokument Claude: → list_text_frames → get_text_frame_detail Im Dokument befinden sich 12 Textrahmen. Die Überschrift „My Design" verwendet Noto Sans JP Bold 48px, Farbe #333333 ... ``` ``` Du: FĂŒhre einen Preflight fĂŒr die Druckvorstufe durch Claude: → preflight_check ⚠ 2 Warnungen: - Bild mit geringer Auflösung: image_01.jpg (150dpi) — 300dpi oder höher empfohlen - Nicht in Pfade umgewandelte Schriften: 3 Textrahmen ``` ``` Du: PrĂŒfe Texte auf Inkonsistenzen Claude: → check_text_consistency 📝 Konsistenzbericht: ⚠ „Contact Us" vs „Contact us" — abweichende Groß-/Kleinschreibung ❌ „Lorem ipsum" (an 2 Stellen) — Platzhaltertext verblieben ``` ``` Du: Erstelle Banner-GrĂ¶ĂŸenvarianten aus diesem A4-Flyer Claude: → get_document_info → resize_for_variation 3 GrĂ¶ĂŸenvarianten erstellt: - 728×90 / 300×250 / 160×600 ``` --- ## 🆚 Vergleich mit Adobes offiziellem Illustrator MCP **Kurz gesagt: Alles, was der offizielle MCP kann, kann dieses Projekt auch — und noch einiges mehr.** Adobe liefert einen integrierten MCP-Server in der **Illustrator Beta** (ab 30.4, Stand August 2026 weiterhin nur in der Beta), ausgerichtet auf die Analyse und Stapelverarbeitung bestehender Dokumente. Dieses Projekt deckt dieselben Workflows ab — Analyse, Massen-UmfĂ€rbung, Varianten, Stapel-Export von ZeichenflĂ€chen, Schrift- / VerknĂŒpfungsprĂŒfungen — und ergĂ€nzt, was der offizielle Server nicht bietet: **das Erstellen von Grund auf, das Speichern von Dokumenten, Druck- und Druckvorstufen-PrĂŒfungen sowie Design-System-Werkzeuge**. Und das alles lĂ€uft im stabilen Illustrator — ganz ohne Beta. | | Dieses Projekt | Adobes offizieller MCP (Beta) | |---|---|---| | Installation | npm (`npx illustrator-mcp-server`) oder `.mcpb` per Ein-Klick-Installation | In Illustrator Beta integriert — Auth-SchlĂŒssel + URL in den App-Einstellungen abrufen, Verbindung ĂŒber `mcp-remote` | | UnterstĂŒtzte Versionen | Illustrator 2024+ verifiziert / 2020+ unverifiziert (macOS / Windows) | Nur Illustrator Beta 30.4+ | | Anzahl der Werkzeuge | 67 | ca. 40 | | Analyse & Stapelverarbeitung bestehender Dokumente | ✅ Struktur- / Farb- / Schriftanalyse, Massen-UmfĂ€rbung, Varianten & DatensĂ€tze, Stapel-Export aller ZeichenflĂ€chen (`artboard:all`), Preflight fĂŒr Schriften & defekte VerknĂŒpfungen | ✅ Sein Hauptfokus | | Objekte von Grund auf erstellen | ✅ Kompletter Satz — Dokumente, Formen, Pfade, Textrahmen, Pfadtext, VerlĂ€ufe | ❌ Keine neuen Objekte, Textrahmen oder Dokumente \* | | Dokumente speichern | ✅ `save_document` (Speichern / Speichern unter) | ❌ Nur Export \* | | Druck & Druckvorstufe | ✅ Schnittmarken, Preflight, Überdrucken- / Separationsinfos, Umwandlung in Pfade, Farbprofile | — | | Designsystem | ✅ Design-Tokens, WCAG-KontrastprĂŒfung, Styleguides, Textkonsistenz | — | \* Basierend auf Nutzerberichten, Stand April 2026 (Beta). Der offizielle Server wird aktiv weiterentwickelt — den aktuellen Stand findest Du in der [Adobe-Dokumentation](https://helpx.adobe.com/illustrator/desktop/connect-with-other-apps-and-tools/about-using-ai-tools-with-illustrator.html). --- ## 📖 Rezepte
Farben und Schriften fĂŒr CSS extrahieren ``` Du: Fasse die Farben und Typografie in diesem Design zusammen Claude: → get_colors → list_text_frames → get_text_frame_detail ■ Farbpalette - Primary: #1A73E8 (CMYK: 85,50,0,0) - Secondary: #34A853 - Text: #202124 - Hintergrund: #FFFFFF ■ Typografie - Überschriften: Noto Sans JP Bold / 32px - Fließtext: Noto Sans JP Regular / 16px / line-height: 1.75 - Bildunterschriften: Noto Sans JP Medium / 12px ```
ZeichenflĂ€chen als SVG / PNG exportieren ``` Du: Exportiere alle ZeichenflĂ€chen als SVG mit in Pfade umgewandeltem Text Claude: → get_artboards → convert_to_outlines → export (wiederholt) 4 ZeichenflĂ€chen exportiert: - /output/header.svg - /output/hero.svg - /output/feature.svg - /output/footer.svg ```
PDF/X-1a-KonformitĂ€t vor der Abgabe prĂŒfen ``` Du: PrĂŒfe, ob dieses Dokument PDF/X-1a-konform ist Claude: → preflight_check (target_pdf_profile: "x1a") ❌ Fehler bei der PDF/X-1a-KonformitĂ€t: - Transparenzen auf 3 Objekten (X-1a verbietet Transparenz) - RGB-Farben an 2 Stellen gefunden (X-1a verlangt ausschließlich CMYK/Sonderfarben) ⚠ Warnungen: - 5 nicht in Pfade umgewandelte Schriften (Einbetten empfohlen) - Bild „photo_02.jpg" mit 150dpi (300dpi empfohlen) ```
BildqualitĂ€t fĂŒr den Druck prĂŒfen ``` Du: PrĂŒfe die QualitĂ€t der platzierten Bilder fĂŒr den Druck Claude: → get_images (include_print_info: true) ■ BildqualitĂ€tsbericht: ✅ hero.psd — CMYK, 350dpi, Skalierung 98% ⚠ icon_set.png — RGB (Diskrepanz zum CMYK-Dokument), 300dpi, Skalierung 100% ❌ photo_bg.jpg — CMYK, 72dpi, Skalierung 400% (zu stark vergrĂ¶ĂŸert) → Durch ein Bild mit 300dpi+ in OriginalgrĂ¶ĂŸe ersetzen ```
WCAG-FarbkontrastverhĂ€ltnisse prĂŒfen ``` Du: PrĂŒfe die TextkontrastverhĂ€ltnisse Claude: → check_contrast (auto_detect: true) ■ WCAG-Kontrastbericht: ❌ „Caption" auf „hellgrau" — 2.8:1 (AA nicht bestanden) ⚠ „Subheading" auf „weiß" — 4.2:1 (AA Large OK, AA Normal nicht bestanden) ✅ „Body text" auf „weiß" — 12.1:1 (AAA bestanden) ```
--- ## Workflow-Vorlagen Vorgefertigte Workflow-Vorlagen stehen im Prompt-Picker von Claude Desktop zur VerfĂŒgung. | Vorlage | Beschreibung | |----------|-------------| | `quick-layout` | Text einfĂŒgen und Claude ordnet ihn auf der ZeichenflĂ€che als Überschrift, Fließtext und Bildunterschrift an | | `print-preflight-workflow` | Umfassende 7-stufige Druckvorstufen-PrĂŒfung (Dokument → Preflight → Überdrucken → FarbauszĂŒge → Bilder → Farben → Text) | --- ## Werkzeug-Referenz ### Read-Werkzeuge (21)
Zum Aufklappen klicken | Werkzeug | Beschreibung | |---|---| | `get_document_info` | Dokument-Metadaten (Maße, Farbmodus, Profil usw.) | | `get_artboards` | Informationen zu ZeichenflĂ€chen (Position, GrĂ¶ĂŸe, Ausrichtung) | | `get_layers` | Ebenenstruktur als Baum | | `get_document_structure` | VollstĂ€ndiger Baum: Ebenen → Gruppen → Objekte in einem Aufruf | | `list_text_frames` | Liste der Textrahmen (Schrift, GrĂ¶ĂŸe, Stilname) | | `get_text_frame_detail` | Alle Attribute eines bestimmten Textrahmens (Unterschneidung, Absatzeinstellungen usw.) | | `get_colors` | Verwendete Farbinformationen (Farbfelder, VerlĂ€ufe, Sonderfarben). `include_diagnostics` fĂŒr Druckanalyse | | `get_path_items` | Pfad-/Formdaten (FĂŒllung, Kontur, Ankerpunkte) | | `get_groups` | Gruppen, Schnittmasken und zusammengesetzte Pfadstruktur | | `get_effects` | Effekte und Aussehen-Infos (Deckkraft, FĂŒllmethode) | | `get_images` | Info zu eingebetteten/verknĂŒpften Bildern (Auflösung, Erkennung defekter VerknĂŒpfungen). `include_print_info` fĂŒr Farbraum-Diskrepanz und Skalierungsfaktor | | `get_symbols` | Symboldefinitionen und -instanzen | | `get_guidelines` | Informationen zu Hilfslinien | | `get_overprint_info` | Überdrucken-Einstellungen + K100/Tiefschwarz-Erkennung und Klassifizierung der Absicht | | `get_separation_info` | Farbauszugs-Info (CMYK-Prozessplatten + Sonderfarbenplatten mit NutzungszĂ€hlung) | | `get_selection` | Details der aktuell ausgewĂ€hlten Objekte | | `find_objects` | Suche nach Kriterien (Name, Typ, Farbe, Schrift usw.) | | `check_contrast` | PrĂŒfung des WCAG-Farbkontrasts (manuell oder automatische Erkennung ĂŒberlappender Paare) | | `extract_design_tokens` | Design-Tokens als CSS Custom Properties, JSON oder Tailwind-Config extrahieren | | `list_fonts` | Listet in Illustrator verfĂŒgbare Schriften auf (kein Dokument erforderlich) | | `convert_coordinate` | Punkte zwischen ZeichenflĂ€chen- und Dokument-Koordinatensystemen umrechnen |
### Modify-Werkzeuge (38)
Zum Aufklappen klicken | Werkzeug | Beschreibung | |---|---| | `create_rectangle` | Rechteck erstellen (unterstĂŒtzt abgerundete Ecken) | | `create_ellipse` | Ellipse erstellen | | `create_line` | Linie erstellen | | `create_text_frame` | Textrahmen erstellen (Punkt- oder FlĂ€chentext) | | `create_path` | Benutzerdefinierten Pfad erstellen (mit BĂ©zier-Griffen) | | `place_image` | Eine Bilddatei verknĂŒpft oder eingebettet platzieren | | `modify_object` | Eigenschaften eines vorhandenen Objekts Ă€ndern | | `convert_to_outlines` | Text in Pfade umwandeln | | `assign_color_profile` | Ein Farbprofil zuweisen (taggen) (konvertiert keine Farbwerte) | | `create_document` | Neues Dokument erstellen (GrĂ¶ĂŸe, Farbmodus) | | `close_document` | Aktives Dokument schließen | | `resize_for_variation` | GrĂ¶ĂŸenvarianten aus einer Quell-ZeichenflĂ€che erstellen (proportionale Skalierung) | | `align_objects` | Mehrere Objekte ausrichten und verteilen | | `replace_color` | Farben dokumentweit suchen und ersetzen (mit Toleranz) | | `manage_layers` | Ebenen hinzufĂŒgen, umbenennen, ein-/ausblenden, sperren/entsperren, neu anordnen oder löschen | | `place_color_chips` | Eindeutige Farben extrahieren und Farbfeld-Swatches außerhalb der ZeichenflĂ€che platzieren | | `save_document` | Aktives Dokument speichern oder „Speichern unter" | | `open_document` | Ein Dokument aus einem Dateipfad öffnen | | `group_objects` | Objekte gruppieren (unterstĂŒtzt Schnittmasken) | | `ungroup_objects` | Eine Gruppe auflösen und Kinder freigeben | | `duplicate_objects` | Objekte duplizieren mit optionalem Versatz | | `set_z_order` | Stapelreihenfolge Ă€ndern (vorn/hinten) | | `move_to_layer` | Objekte auf eine andere Ebene verschieben | | `delete_objects` | Objekte per UUID löschen (gesperrte Objekte benötigen `force_unlock`; mit `undo` rĂŒckgĂ€ngig machbar) | | `manage_artboards` | ZeichenflĂ€chen hinzufĂŒgen, entfernen, skalieren, umbenennen, neu anordnen | | `manage_swatches` | Farbfelder hinzufĂŒgen, aktualisieren oder löschen | | `manage_linked_images` | Platzierte Bilder neu verknĂŒpfen oder einbetten | | `manage_datasets` | DatensĂ€tze auflisten/anwenden/erstellen, Variablen importieren/exportieren | | `apply_graphic_style` | Einen Grafikstil auf Objekte anwenden | | `list_graphic_styles` | Alle Grafikstile im Dokument auflisten | | `apply_text_style` | Zeichen- oder Absatzformat auf Text anwenden | | `list_text_styles` | Alle Zeichen- und Absatzformate auflisten | | `create_gradient` | VerlĂ€ufe erstellen und auf Objekte anwenden | | `create_path_text` | Text entlang eines Pfads erstellen | | `place_symbol` | Symbolinstanzen platzieren oder ersetzen | | `select_objects` | Objekte nach UUID auswĂ€hlen (Mehrfachauswahl unterstĂŒtzt) | | `create_crop_marks` | Schnittmarken (Beschnittzeichen) erstellen mit automatischer Stilerkennung nach Locale (japanische Doppellinie / westliche Einzellinie) | | `place_style_guide` | Einen visuellen Styleguide außerhalb der ZeichenflĂ€che platzieren (Farben, Schriften, AbstĂ€nde, RĂ€nder, HilfslinienabstĂ€nde) | | `undo` | RĂŒckgĂ€ngig-/Wiederholen-Operationen (mehrstufig) |
### Export-Werkzeuge (2)
Zum Aufklappen klicken | Werkzeug | Beschreibung | |---|---| | `export` | SVG- / PNG- / JPG-Export (nach ZeichenflÀche, Auswahl oder UUID) | | `export_pdf` | Druckfertiger PDF-Export (Schnittmarken, Beschnitt, selektive Neuberechnung der Auflösung, Output Intent) |
### Utility (3)
Zum Aufklappen klicken | Werkzeug | Beschreibung | |---|---| | `preflight_check` | Druckvorstufen-PrĂŒfung (RGB-Vermischung, defekte VerknĂŒpfungen, niedrige Auflösung, WeiĂŸĂŒberdruck, Zusammenspiel von Transparenz und Überdrucken, PDF/X-KonformitĂ€t usw.) | | `check_text_consistency` | TextkonsistenzprĂŒfung (Platzhaltererkennung, Schreibweisen-Abweichungen, vollstĂ€ndige Textauflistung fĂŒr LLM-Analyse) | | `set_workflow` | Workflow-Modus setzen (web/print), um das automatisch erkannte Koordinatensystem zu ĂŒberschreiben |
--- ## Koordinatensystem Der Server erkennt das Koordinatensystem automatisch anhand des Dokuments: | Dokumenttyp | Koordinatensystem | Ursprung | Y-Achse | |---|---|---|---| | CMYK / Print | `document` | unten links | nach oben | | RGB / Web | `artboard-web` | oben links der ZeichenflĂ€che | nach unten | - **CMYK-Dokumente** verwenden das native Koordinatensystem von Illustrator, das den Erwartungen von Druckdesignerinnen und Druckdesignern entspricht - **RGB-Dokumente** verwenden ein web-artiges Koordinatensystem, mit dem die KI leichter arbeiten kann - Verwende `set_workflow`, um das automatisch erkannte Koordinatensystem bei Bedarf zu ĂŒberschreiben - Alle Tool-Antworten enthalten ein Feld `coordinateSystem`, das angibt, welches System aktiv ist --- ## Beispiel: SMPTE-Testbild Ein 1920×1080 SMPTE-Farbbalken-Testbild, vollstĂ€ndig durch natĂŒrlichsprachige Anweisungen an Claude erstellt. **Prompt:** > Erstelle ein 1920x1080 Video-Testbild **Ergebnis:** SMPTE-Farbbalken-Testbild, generiert von Claude via illustrator-mcp-server **ZeichenflĂ€chen-Struktur** (via `get_document_structure`):
Zum Aufklappen klicken ``` 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 ```
> Verwendete Werkzeuge: `create_document`, `manage_layers`, `create_rectangle` ×23, `create_line` ×2, `create_ellipse`, `create_text_frame` ×6, `modify_object` ×4, `save_document`, `export` --- ## Beispiel: Twilight Geometry Eine abstrakte, geometrische Landschaftsgrafik — vollstĂ€ndig von Claude erstellt, ohne weitere menschliche Designvorgabe als „mach, worauf Du Lust hast". **Prompt:** > Make an art piece of your own imagination in Illustrator. Take your time. Create whatever you like. **Claudes Vorgehen:** > Ich erstelle „Twilight Geometry" — eine abstrakte Landschaft mit geometrischen Himmelselementen. Ein tiefer Verlauf als DĂ€mmerhimmel, geschichtete Berg-Silhouetten, ein Halbmond mit dekorativen Ringen und ĂŒber die Leinwand verstreute Sterne. > Rautenförmige Sterne in verschiedenen Farben — warme Weißtöne, kĂŒhles Blau, lavendelfarbenes Violett — jeder einzelne leicht unterschiedlich, um verschiedene Sterntypen anzudeuten. Konstellationslinien verbinden sie. Drahtgitter-Dreiecke und ein Hexagon schweben am Himmel fĂŒr eine mystische AtmosphĂ€re. > Am unteren Rand eine WasseroberflĂ€che, in der sich das Mondlicht als schimmernde Wellenlinien spiegelt, die nach unten hin ausblenden. **Claudes Reflexion:** > Es ist besser geworden, als ich erwartet hatte. Ich finde, die Mischwelt aus Geometrie und Natur ist gut rĂŒbergekommen. **Ergebnis:** Twilight Geometry — abstrakte geometrische Landschafts-Grafik, generiert von Claude via illustrator-mcp-server > Verwendete Werkzeuge: `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` --- ## Bekannte EinschrĂ€nkungen | EinschrĂ€nkung | Details | |---|---| | Windows-UnterstĂŒtzung | Windows nutzt PowerShell-COM-Automatisierung (noch nicht auf echter Hardware getestet) | | Live-Effekte | Parameter von Schlagschatten und anderen Effekten können erkannt, aber nicht ausgelesen werden | | Farbprofile | Nur Zuweisung von Farbprofilen — eine vollstĂ€ndige Konvertierung ist nicht verfĂŒgbar | | Beschnittseinstellungen | Beschnittseinstellungen können nicht ausgelesen werden (EinschrĂ€nkung der Illustrator-API) | | WebP-Export | Nicht unterstĂŒtzt — verwende stattdessen PNG oder SVG | | Japanische Schnittmarken | Der PDF-Export verwendet automatisch den TrimMark-Befehl: Marken werden als Dokumentpfade erzeugt, exportiert und anschließend per Undo entfernt | | Einbetten von Schriften | Einbettungsmodus (vollstĂ€ndig/Subset) kann nicht direkt gesteuert werden — nutze PDF-Vorgaben | | GrĂ¶ĂŸenvarianten | Nur proportionale Skalierung — Text muss ggf. anschließend manuell nachjustiert werden | ---
# FĂŒr Entwicklerinnen und Entwickler ## Architektur ```mermaid flowchart LR Claude <-->|MCP Protocol| Server["MCP Server\n(TypeScript/Node.js)"] 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 ``` --- ## Aus dem Quellcode bauen ```bash 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 ``` ### ÜberprĂŒfen ```bash npx @modelcontextprotocol/inspector npx illustrator-mcp-server ``` ### Tests ```bash # Unit-Tests npm test # E2E-Smoketest (Illustrator muss laufen) npx tsx test/e2e/smoke-test.ts ``` Der E2E-Test erstellt frische Dokumente (RGB + CMYK), platziert Testobjekte, fĂŒhrt 182 TestfĂ€lle in 10 Phasen aus, die alle registrierten Werkzeuge sowie die automatische Erkennung des Koordinatensystems abdecken, und rĂ€umt am Ende automatisch auf. --- ## Besonderer Dank Dank an die folgenden Personen fĂŒr Feedback, das dieses Projekt geprĂ€gt hat: - [OKI Yoshiya (@448jp)](https://github.com/448jp) --- ## Haftungsausschluss Dieses Tool automatisiert viele Illustrator-Operationen, aber KI kann Fehler machen. Extrahierte Daten, Preflight-Ergebnisse und DokumentĂ€nderungen sollten immer von einem Menschen ĂŒberprĂŒft werden. **Verlasse Dich nicht auf dieses Tool als Deine einzige QualitĂ€tskontrolle.** Nutze es als Assistenz neben Deiner eigenen manuellen PrĂŒfung, besonders bei Druckabgaben und Kundenlieferungen. Die Autorinnen und Autoren ĂŒbernehmen keine Haftung fĂŒr SchĂ€den oder Verluste, die aus der Nutzung dieser Software oder ihrer Ergebnisse entstehen. --- ## Lizenz [MIT](LICENSE)