inkscape-mcp

Local MCP server, via stdio, for bounded headless control of Inkscape. This pre-alpha version focuses on SVG/Inkscape documents, sizes, pages, and verified exports to PNG, PDF, and SVG.

What works today

• Inkscape discovery, including the Windows MSIX package, and --doctor with capability evidence.

• Authorized workspaces with safe relative paths, SHA-256 revisions, locks, backups, and atomic commits.

• Create, inspect, and resize SVG documents with page_only semantics, custom measurements, or A3/A4/Letter presets, and initial pages.

• Explicit Inkscape 1.4 pages: list, add, update, delete, and reorder with stable IDs.

• Typed page settings: page color/opacity, desktop color, and border color/opacity.

• Basic SVG preflight and PNG, PDF 1.4/1.5, and flat or Inkscape SVG exports. Results are verified before publishing.

It is not yet a complete vector editor: it does not announce general manipulation of objects, layers, text, paths, selections, filters, or local dependencies. See the master plan for scope and pending tasks.

Related MCP server: SVG Maker MCP Server

Requirements

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

• Inkscape 1.4.4 or compatible. On Windows, the MSIX installation observed during development is detected automatically.

Run locally

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

The last command keeps the MCP protocol exclusively on stdout. Configure your MCP client to launch it with node, argument dist/cli.js, and one or more --workspace-root arguments; only those directories will be visible to the document tools.

Current MCP tools

Mutations and exports require expectedRevision. If a file changes between read and commit, the operation fails instead of overwriting someone else's revision. Every export provides Inkscape with a verified copy of the SVG in staging, never the live workspace path.

Security and status

The project does not promise to isolate unknown vulnerabilities in native parsers. It limits paths, XML, arguments, processes, sizes, and overwrites; the current native input policy is trusted-local-only. Export rejects SVG with active content or remote resources before starting Inkscape; resize mutations apply the same rule.

Contribution instructions and invariants are in AGENTS.md. The package remains private: publishing it to npm or a registry will require separate explicit authorization.

License

MIT Copyright 2026 Berrio.