Illustrator Figure MCP

Rekonstruieren Sie wissenschaftliche Abbildungen als bearbeitbare Adobe-Illustrator-Grafiken neu und beweisen Sie, dass das Ergebnis strukturell korrekt ist.

Nur macOS (Illustrator ist für macOS/Windows verfügbar; dies verwendet osascript → do javascript). Erfordert Adobe Illustrator und Claude Code.

Warum es das gibt

Viele MCP-Server können in Illustrator zeichnen. Sie geben einem Modell Hände, aber keine Augen: Nichts prüft, ob das, was es gerade gezeichnet hat, richtig ist. Also zeichnet das Modell, meldet Erfolg, und die Abbildung hat ein Label, das aus seiner Box überläuft, einen Pfeil, der in der Mitte eines unzusammenhängenden Rechtecks endet, und drei „ausgerichtete“ Panels, die 3pt daneben liegen.

Der wertvolle Teil ist nicht das Zeichnen. Es ist die Validierungs- und Reparaturschleife, die auf zwei Kanälen unterschiedliche Dinge prüft:

Geometrie wird bewiesen. Ähnlichkeit wird beurteilt. Keines allein reicht aus – eine nachgezeichnete Abbildung besteht jede geometrische Prüfung, ist aber völlig nicht editierbar, und eine gut aussehende Darstellung sagt nichts über die Struktur aus.

Wenn audit_figure passed: true zurückgibt, bedeutet das keinen harten geometrischen Fehler. Es bedeutet nicht, dass die Abbildung korrekt ist.

Related MCP server: Illustrator MCP Vectorizer

Rekonstruieren, nie nachzeichnen

Nachzeichnen erhält das Erscheinungsbild und zerstört die Semantik, was der ganze Sinn des Neuaufbaus einer Abbildung ist. Drei Verteidigungslinien machen die Abkürzung schwer zu nehmen:

• Semantische Kennzeichnung bei der Erstellung. Jedes Objekt erhält eine UUID und einen semantischen Typ, wenn es erstellt wird, damit der Prüfer konstruierte Objekte von fremder Geometrie unterscheiden kann.

• trace-signature. Image Traces expandTracing() erzeugt eine nicht gekennzeichnete Gruppe mit einem Haufen nicht gekennzeichneter Pfade; das, dichte nicht gekennzeichnete Pfade und Massengeometrie, die das deklarierte Zeichenprotokoll überschreitet, sind alles harte Fehler.

• Das Raster-Gate. place_image verweigert jede Platzierung, die nicht nachweislich irreduzibel ist.

Das Raster-Gate

Jedes beibehaltene Bild muss alle fünf deklarieren, und sie werden validiert, nicht nur aufgezeichnet:

Die Durchsetzung erfolgt auf dem Erstellungspfad, nicht im Prüfer: Eine nur im Prüfer vorhandene Prüfung wird umgangen, indem man nicht prüft.

Verbinder

Illustrator hat kein Verbinder-Primitiv. Ein Pfeil ist ein PathItem und hat keine Beziehung zu der Box, auf die er zeigt – bewegen Sie die Box, und der Pfeil bleibt zurück, stillschweigend falsch.

add_connector zeichnet die Bindung (Quelle, Ziel, Anheftungspunkte) auf dem Pfad auf. reflow_connectors löst die Geometrie aus den aktuellen Grenzen der Objekte neu. audit_figure meldet connector-detached, wenn der gezeichnete Pfad nicht mehr mit seiner Bindung übereinstimmt.

Das Routing ist straight, orthogonal oder curved – ein Bezier, der senkrecht zu den Anheftungskanten abgeht und ankommt, was das Standard-Aussehen von Pfaddiagrammen ist und Pfeilspitzen so erscheinen lässt, als zeigten sie direkt auf ihr Ziel. Der Prüfer tastet die tatsächliche Kurve ab, nicht die Sehne zwischen den Ankern, und prüft so, wo die Tinte ist.

Jede Operation, die ein verbundenes Objekt bewegt oder seine Größe ändert, muss von reflow_connectors gefolgt werden. Pfeilspitzen werden als gefüllte Dreiecke gezeichnet, da Illustrator keine Pfeilspitzen-Eigenschaft für Skripte bereitstellt.

→ Vollständige Anleitung – Installation, Kernregeln, Werkzeugreferenz, zwei durchgearbeitete Beispiele und wie man einen Prüfbericht liest.

Installation

npm install && npm run build

Fügen Sie es zu Claude Code hinzu:

claude mcp add illustrator-figure -- node /absolute/path/to/IllustratorFigureMCP/dist/index.js

Erteilen Sie beim ersten Ausführen eines Werkzeugs die Automatisierungsberechtigung: Systemeinstellungen → Datenschutz & Sicherheit → Automatisierung → Claude → Adobe Illustrator.

Installieren Sie die vier Rollen-Fähigkeiten:

cp -R skills/* ~/.claude/skills/

Die vier Rollen

Bitten Sie Claude, „Erstellen Sie diese Abbildung in Illustrator neu“ mit einem Referenzbild auszuführen, und recreate-scientific-figure koordiniert die Schleife:

Jede Region muss bestehen, bevor die nächste beginnt; dann durchläuft die gesamte Abbildung dieselbe Schleife.

Von diesem Fork hinzugefügte Werkzeuge

Plus das Raster-Gate auf place_image und semantische Kennzeichnung auf jedem create_*-Werkzeug. Die restlichen 66 Werkzeuge stammen vom Upstream (insgesamt 71).

draw_sequence ist das Werkzeug der Wahl: neun Objekte – Boxen, Flächentext-Labels, zwei gebundene Verbinder – werden in etwa 750 ms aufgebaut und geprüft, während ein Aufruf pro Objekt neun Roundtrips bedeuten würde.

Dokumentation

Entwicklung

npm test        # 245 tests, runs on any platform

Die portierte Geometrie ist reines ES3, daher werden die .jsx-Module in eine VM geladen und die Liang–Barsky- und Segmentkreuzungs-Mathematik wird ohne Illustrator getestet. Alles, was Illustrator berührt, muss auf macOS mit laufendem Illustrator getestet werden – siehe CLAUDE.md für die Einschränkungen, die leicht zu brechen sind (ES3, UUID-vor-Metadaten-Reihenfolge, pageItems-Snapshotting).

Danksagungen

• Werkzeugschicht gegabelt von ie3jp/illustrator-mcp-server (MIT) – Transport, JSX-Runner, UUID-Identität, note-Metadaten und 63 Illustrator-Werkzeuge. Siehe LICENSE.

• Die Zwei-Kanal-Validierungsschleife, die Prüftaxonomie und das Vier-Rollen-Protokoll sind portiert von icebird1998/scientific-illustrator, das sie für draw.io, PowerPoint und WPS implementiert. Die Mathematik ist backend-neutral; das Objektmodell nicht.

Nicht mit Adobe verbunden.