Skip to main content
Glama
Illustrator Figure MCP

Illustrator Figure MCP

by ymo6

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:

Kanal

Mechanismus

Beweist

Geometrie

audit_figure — deterministisch, schreibgeschützt

interne Korrektheit: Enthaltensein, degenerierte Größen, doppelte Namen, überlaufender Text, Rasterdeklarationen, Verbindungsrouting und -bindungen, Ausrichtung wiederholter Serien, Trace-Signaturen

Erscheinungsbild

export als PNG, verglichen mit dem Referenzausschnitt

Ähnlichkeit

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: visualspec

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:

Deklaration

Anforderung

raster_reason

spezifische Beschreibung des irreduziblen Pixelinhalts – „image“, „PNG“, „screenshot“ werden abgelehnt

source_is_tightly_cropped

true – jeder Rand, jedes Label, jeder Pfeil, jede Legende, jede Achse und jedes benachbarte Panel weggeschnitten

atomic_raster_unit

true – ein unteilbares Datum, kein Raster oder Montage

contains_reconstructable_content

false – nichts im Inneren, das ein editierbares Objekt sein sollte

decomposition_note

≥ 8 Zeichen: was herausgelöst und neu aufgebaut wurde

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:

Fähigkeit

Rolle

design-scientific-figure

Designer – erstellt die Rekonstruktionsspezifikation, bevor etwas gezeichnet wird

recreate-scientific-figure

Zeichner + Orchestrator – baut eine Region pro Roundtrip, führt die Gates aus

audit-scientific-figure

Prüfer – liest beide Beweiskanäle, gibt Befunde aus

correct-scientific-figure

Korrektor – wandelt Befunde in geordnete Operationen auf Objektebene um

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

Von diesem Fork hinzugefügte Werkzeuge

Werkzeug

Zweck

audit_figure

deterministische Strukturprüfung; jeder Befund trägt Beweise, eine Korrektur und ein Akzeptanzkriterium

draw_sequence

eine ganze Region in einem Roundtrip aufbauen, optional mit Prüfung im selben Aufruf

add_connector

einen Verbinder erstellen, der per Name an zwei Objekte gebunden ist

reflow_connectors

Verbindungsgeometrie neu lösen, nachdem Objekte bewegt wurden

fit_text

überlaufenden Flächentext auflösen – das Ändern der Rahmengröße mit modify_object lässt ihn nicht neu umbrechen

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

docs/USAGE.md

So verwenden Sie es: Installation, Regeln, jedes Werkzeug, durchgearbeitete Beispiele, Prüfbefunde, Fehlerbehebung

CLAUDE.md

Interna und die Einschränkungen, die leicht zu brechen sind, für alle, die dieses Repo bearbeiten

skills/

Die vier Rollen-Fähigkeiten

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.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    MCP server that renders AI-authored documents to images and returns typed diagnostics for self-correction. It also provides visual QA metrics, raster-to-vector reconstruction, and image-to-draft proposals.
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to convert natural-language briefs into structured visual specs, deterministically render typography and layouts, and run constraint-aware visual QA and targeted repair for image generation.
    45 npm
    Apache 2.0
  • A
    license
    Not graded
    quality
    A
    maintenance
    Converts raster drawings such as diagrams, maps, charts, and scans into editable CorelDRAW vector files in a single call, with automatic self-checking that reports uncertain elements back to the calling AI for correction and rebuild.
    4
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to create and edit vector drawing documents over MCP, with tools to draw shapes, read document outlines, and render PNG previews while humans work in the same Illustrator-style canvas.
    Apache 2.0