inkscape-mcp

Lokaler MCP-Server über stdio zur begrenzten Steuerung von Inkscape im Headless-Modus. Diese Pre-Alpha-Version konzentriert sich auf SVG-/Inkscape-Dokumente, Größen, Seiten und verifizierte Exporte nach PNG, PDF und SVG.

Was heute funktioniert

• Erkennung von Inkscape, einschließlich des Windows-MSIX-Pakets, und --doctor mit Nachweis der Fähigkeiten.

• Autorisierte Workspaces mit sicheren relativen Pfaden, SHA-256-Prüfsummen, Sperren, Backups und atomaren Commits.

• Erstellen, Inspizieren und Ändern der Größe von SVG-Dokumenten mit page_only-Semantik, benutzerdefinierten Maßen oder A3/A4/Letter-Presets sowie Startseiten.

• Explizite Inkscape-1.4-Seiten: Auflisten, Hinzufügen, Aktualisieren, Löschen und Neuordnen mit stabilen IDs.

• Typisierte Seiteneinstellungen: Seitenfarbe/-deckkraft, Desktopfarbe und Rahmenfarbe/-deckkraft.

• Grundlegender SVG-Preflight und PNG-Exporte, PDF 1.4/1.5 und flaches oder Inkscape-SVG. Die Ergebnisse werden vor der Veröffentlichung verifiziert.

Es ist noch kein vollständiger Vektor-Editor: Es werden keine allgemeine Objektmanipulation, Ebenen, Text, Pfade, Auswahlen, Filter oder lokale Abhängigkeiten angekündigt. Siehe den Masterplan für den Umfang und die offenen Aufgaben.

Related MCP server: SVG Maker MCP Server

Voraussetzungen

• Node.js 24.x und npm 11.x.

• Inkscape 1.4.4 oder kompatibel. Unter Windows wird die während der Entwicklung beobachtete MSIX-Installation automatisch erkannt.

Lokal ausführen

npm ci
npm run check
npm run test:mcp
node dist/cli.js --doctor --json
node dist/cli.js --workspace-root C:\ruta\a\tus\disenos

Der letzte Befehl hält das MCP-Protokoll ausschließlich auf stdout. Konfiguriere deinen MCP-Client so, dass er es mit node, dem Argument dist/cli.js und einem oder mehreren Argumenten --workspace-root startet; nur diese Verzeichnisse sind für die Dokument-Tools sichtbar.

Aktuelle MCP-Tools

Mutationen und Exporte erfordern expectedRevision. Wenn sich eine Datei zwischen dem Lesen und dem Commit ändert, schlägt die Operation fehl, anstatt eine fremde Revision zu überschreiben. Jeder Export übergibt Inkscape eine verifizierte Kopie des SVG im Staging, niemals den Live-Pfad des Workspace.

Sicherheit und Status

Das Projekt verspricht nicht, unbekannte Schwachstellen nativer Parser zu isolieren. Es begrenzt Pfade, XML, Argumente, Prozesse, Größen und Überschreibungen; die aktuelle Richtlinie für native Eingaben ist trusted-local-only. Der Export lehnt SVG mit aktiven Inhalten oder entfernten Ressourcen ab, bevor Inkscape gestartet wird; Resize-Mutationen wenden dieselbe Regel an.

Die Beitragsanweisungen und Invarianten finden sich in AGENTS.md. Das Paket bleibt privat: Die Veröffentlichung auf npm oder in einem Registry erfordert eine separate ausdrückliche Genehmigung.

Lizenz

MIT Copyright 2026 Berrio.