English Français العربية

Inkscape (inksmcp)

السجل الرسمي أخرى

Create, edit and export SVG graphics with Inkscape: measured layout, templates, export.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package inksmcp
Claude Code 
claude mcp add inkscape-inksmcp -e 'INKSCAPE_PATH=<INKSCAPE_PATH>' -- uvx inksmcp==0.3.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "inkscape-inksmcp": {
            "command": "uvx",
            "args": [
                "inksmcp==0.3.0"
            ],
            "env": {
                "INKSCAPE_PATH": "<INKSCAPE_PATH>"
            }
        }
    }
}

متغيرات البيئة

  • INKSCAPE_PATH Path to the Inkscape executable, if it is not on PATH or in the default install location

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. inksmcp
  2. Why inksmcp
  3. Quick start
  4. Tools
  5. How it works
  6. Status
  7. Contributing
  8. License

inksmcp

An MCP server that lets AI assistants create, edit and export vector graphics with Inkscape.

Describe a poster, a diagram, a chart or a comic page to your assistant, and it builds a real SVG document in Inkscape: measured, laid out and exported to PNG or PDF. It can also open drawings made elsewhere and change them.

Made by Claude through inksmcp during field tests, in 13 to 41 tool calls each. The SVG was never edited by hand. The floor plan and the periodic table used a short script to prepare their data.

Why inksmcp

Asking a model to write SVG by hand works for an icon, but it breaks down on real layouts. The model can't measure text, keeps redoing coordinate arithmetic, and can't see what it drew. inksmcp takes that work off the model:

  • Measured, not guessed. Bounding boxes come from Inkscape itself, text included, in the document's own units.
  • Relationships instead of coordinates. align and layout arrange things. place keeps a caption below a title's real glyphs. fit_to sizes a box around its content. connect draws arrows that stay attached when things move.
  • Data-driven. repeat stamps a template per data row (cards, timelines, legends, table rows, character poses). split divides a page into panels or cells. Large data comes from JSON or CSV files, so it doesn't pass through the conversation.
  • Works on existing files. It opens .svg/.svgz drawings from other tools. inspect find locates elements by colour, type, text or symbol. Symbols can be placed from icon libraries.
  • Safe and checkable. Every tool is all-or-nothing. Editing responses warn about overlapping text, and render_preview shows the agent what it drew.
  • Real output. PNG, PDF (optionally with text as paths), plain SVG, EPS, EMF and more, rendered by Inkscape.

Quick start

  1. Install Inkscape 1.x and uv.

  2. Add the server to your MCP client. For Claude Code:

     claude mcp add --scope user inkscape -- uvx inksmcp

    For Claude Desktop, Cursor and others:

     { "mcpServers": { "inkscape": { "command": "uvx", "args": ["inksmcp"] } } }
  3. Ask: "Using the inkscape tools, make an A5 flyer for a book swap on Saturday at 10:00 in the library garden, show me a preview, then export a PDF."

Details for each OS and client, and troubleshooting, are in getting started.

Tools

AreaTools
Documentsdocument_create, document_open, document_save, inspect (outline, real bboxes, find), inkscape_info
Elementsadd_elements (rect, circle, ellipse, line, polyline, polygon, path, text, group, arrow, image, use), update_elements, delete_elements, import_file, repeat
Arrangementalign, layout, split, connect, z_order, move_to_layer, page_fit, page_resize
Chartsgrid (linear/log graph paper and axes), plot (data series in data values)
Pathspath_operation (union, difference, intersection, combine, stroke to path, ...), run_actions (guarded raw Inkscape actions)
Outputrender_preview (PNG back to the agent), export

See the recipes for how they combine, and the tool reference for every parameter.

How it works

The document lives in the server as an lxml tree, which is the source of truth. Edits are applied there directly. Anything that needs Inkscape (measuring, boolean operations, connectors, rendering, export) goes to one persistent inkscape --shell process, so a call takes milliseconds instead of the ~1 s it takes to start Inkscape. The architecture notes have the details.

Status

inksmcp is beta (0.3). It has been through eleven field tests, in which agents used it for real tasks. The latest one edited files made in other tools. There are 160 tests, and they run against the real Inkscape.

Known limits:

  • It is developed on Windows with Inkscape 1.4.4. CI also runs on Linux and macOS.
  • The tool list costs about 9k tokens of context per session.
  • Gradients and patterns can't be created as style keys yet. They can be applied through raw style when they already exist in the document.
  • SVG 1.2 flowed text can be moved but not edited.

The roadmap lists what's next.

Contributing

Bug reports, field reports ("I asked for X, here's what the agent struggled with") and pull requests are welcome. See CONTRIBUTING.md. The project is built experiment-first: every Inkscape behaviour it relies on is proven by a script in experiments/ and guarded by a test. The development handbook explains the method.

License

MIT. Inkscape is a separate program under the GPL; inksmcp calls it as an external process.

الأسئلة الشائعة

ما هو Inkscape (inksmcp)؟

Create, edit and export SVG graphics with Inkscape: measured layout, templates, export.

كيف أثبّت Inkscape (inksmcp)؟

يعمل على جهازك. في Claude Code: claude mcp add inkscape-inksmcp -e 'INKSCAPE_PATH=<INKSCAPE_PATH>' -- uvx inksmcp==0.3.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Inkscape (inksmcp) إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Inkscape (inksmcp) مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Inkscape (inksmcp)؟

ينشره bhanutpt. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.