Inkscape MCP

<p align="center"> <a href="https://github.com/casey/just"><img src="https://img.shields.io/badge/just-ready_to_go-7c5cfc?style=flat-square&logo=just&logoColor=white" alt="Just"></a> <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a> <a href="https://python.org"><img src="https://img.shields.io/badge/Python-3.13+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python"></a> <a href="https://github.com/PrefectHQ/fastmcp"><img src="https://img.shields.io/badge/FastMCP-3.2-7c5cfc?style=flat-square" alt="FastMCP"></a> </p>

MCP server for Inkscape: agents call portmanteau tools (inkscape_file, inkscape_vector, inkscape_analysis, inkscape_system) that drive the Inkscape CLI. Built with FastMCP 3.2.0+.

You need Python 3.12+, uv, and Inkscape on the same machine.

Doc	What
docs/INSTALL.md	Clone uv sync run; PyPI / uvx
docs/INKSCAPE.md	Install Inkscape, PATH, CLI check
docs/IDE_MCP.md	Cursor, VS Code, Windsurf, Glama-style config
docs/MCPB.md	Claude Desktop .mcpb bundle
docs/USAGE.md	How to use the tools from an agent
docs/AI_SAMPLING.md	Agentic tools, ctx.sample(), Ollama env
docs/ARCHITECTURE.md	Layout, transports, modules
llms.txt / llms-full.txt	LLM index + full tool/env/run manifest (fleet)

More: Docs index API Features Troubleshooting Changelog

Quick Start

git clone https://github.com/sandraschi/inkscape-mcp
cd inkscape-mcp
just

This opens an interactive dashboard showing all available commands. Run just bootstrap to install dependencies, then just serve or just dev to start.

Manual Setup

If you don't have just installed:

🛡️ Industrial Quality Stack

This project adheres to SOTA 14.1 industrial standards for high-fidelity agentic orchestration:

• Python (Core): Ruff for linting and formatting. Zero-tolerance for print statements in core handlers (T201).
• Webapp (UI): Biome for sub-millisecond linting. Strict noConsoleLog enforcement.
• Protocol Compliance: Hardened stdout/stderr isolation to ensure crash-resistant JSON-RPC communication.
• Automation: Justfile recipes for all fleet operations (just lint, just fix, just dev).
• Security: Automated audits via bandit and safety.

License

MIT see LICENSE.