inkscape-mcp

本地 MCP 服务器，通过 stdio 以受限方式控制无头 Inkscape。此 pre-alpha 版本专注于 SVG/Inkscape 文档、尺寸、页面以及经过验证的 PNG、PDF 和 SVG 导出。

目前可用的功能

• Inkscape 的自动发现，包括 Windows 的 MSIX 软件包，以及带有能力证据的 --doctor。

• 经过授权的工作区，具有安全的相对路径、SHA-256 修订、锁、备份和原子提交。

• 使用 page_only 语义、自定义尺寸或 A3/A4/Letter 预设以及初始页面来创建、检查和调整 SVG 文档的大小。

• Inkscape 1.4 的显式页面：列出、添加、更新、删除和重新排序，具有稳定的 ID。

• 类型化的页面设置：页面颜色/不透明度、桌面颜色以及边框颜色/不透明度。

• 基本的 SVG 预检，以及 PNG、PDF 1.4/1.5 和扁平 SVG 或 Inkscape SVG 导出。结果在发布前经过验证。

它还不是一个完整的矢量编辑器：它不宣称支持常规的对象操作、图层、文本、路径、选区、滤镜或本地依赖。有关范围和尚待完成的任务，请参阅总体计划。

Related MCP server: SVG Maker MCP Server

系统要求

• Node.js 24.x 和 npm 11.x。

• Inkscape 1.4.4 或兼容版本。在 Windows 上，会自动检测开发过程中观察到的 MSIX 安装。

本地运行

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

最后一条命令使 MCP 协议仅保留在 stdout 上。配置你的 MCP 客户端，使用 node、参数 dist/cli.js 以及一个或多个 --workspace-root 参数来启动它；只有这些目录对文档工具可见。

当前的 MCP 工具

变更操作和导出都要求提供 expectedRevision。如果文件在读取和提交之间发生变化，操作将失败，而不是覆盖他人的修订。每次导出都会向 Inkscape 提供暂存区中经过验证的 SVG 副本，而绝不会是工作区中的实时路径。

安全与状态

该项目不承诺隔离原生解析器的未知漏洞。它限制路径、XML、参数、进程、大小和覆盖行为；当前的原生输入策略是 trusted-local-only。导出操作会在启动 Inkscape 之前拒绝包含活动内容或远程资源的 SVG；调整大小的变更操作也适用同样的规则。

贡献说明和不变式见 AGENTS.md。该软件包仍为私有：发布到 npm 或任何 registry 都需要单独明确的授权。

许可证

MIT Copyright 2026 Berrio.