Skip to main content
Glama
deenesjakoruzh
Berrio

inkscape-mcp

by Berrio
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

inkscape-mcp

Локальный MCP-сервер через stdio для ограниченного управления Inkscape в headless-режиме. Эта пред-альфа версия сосредоточена на документах SVG/Inkscape, размерах, страницах и проверенных экспортах в PNG, PDF и SVG.

Что работает сегодня

  • Обнаружение Inkscape, включая пакет MSIX для Windows, и --doctor с подтверждением возможностей.

  • Авторизованные workspaces с безопасными относительными путями, ревизиями SHA-256, блокировками, резервными копиями и атомарными коммитами.

  • Создание, проверка и изменение размера SVG-документов с семантикой page_only, пользовательскими размерами или пресетами A3/A4/Letter, а также начальными страницами.

  • Явные страницы Inkscape 1.4: список, добавление, обновление, удаление и переупорядочивание со стабильными ID.

  • Типизированные настройки страницы: цвет/прозрачность страницы, цвет рабочего стола и цвет/прозрачность границы.

  • Базовая предварительная проверка SVG и экспортов PNG, PDF 1.4/1.5 и плоского SVG или SVG Inkscape. Результаты проверяются перед публикацией.

Это пока не полноценный векторный редактор: не заявлены общие манипуляции с объектами, слоями, текстом, путями, выделениями, фильтрами или локальными зависимостями. Смотрите генеральный план для описания охвата и предстоящих задач.

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-инструменты

Tool

Использование

inkscape_status

Состояние, возможности и позиция по безопасности.

workspace_list, workspace_list_documents

Доступные workspaces и разрешённые SVG/SVGZ.

document_create, document_inspect, document_resize

Создание и управление viewport, единицами измерения, viewBox, страницами, якорями, contain/cover/stretch, ревизией и инвентарём SVG.

document_pages

Список или изменение явных страниц Inkscape 1.4.

document_settings

Чтение или редактирование фона страницы, рабочего стола и границы.

document_preflight

Обнаружение активного содержимого, внешних ресурсов и ошибок с профилями basic/web/print/interchange.

elements_update

Обновление геометрии, базового стиля, текста или метки слоя с помощью типизированных патчей.

elements_arrange

Изменение Z-порядка соседних элементов: front/back/raise/lower, без произвольных индексов или XML-порядка.

elements_group

Группировка соседних элементов или разгруппировка SVG-группы без нарушения внешних ссылок href.

elements_query

Запрос ограниченных сводок по ID, типу или слою, с пагинацией и missingIds.

elements_create

Создание типизированных фигур, текста, групп и слоёв; поддерживает parentId внутри пакета.

elements_delete

Удаление выбранных ID без оставления сломанных фрагментарных ссылок.

elements_transform

Трансформация элементов с типизированными translate, scale, rotate, skew, flip или matrix.

export_png, export_pdf, export_svg

Экспорт через Inkscape с помощью staging и проверка артефакта; PNG принимает area/DPI/фон, PDF сообщает страницы и MediaBox, а SVG может преобразовывать текст в paths.

Мутации и экспорты требуют expectedRevision. Если файл изменяется между чтением и коммитом, операция завершается ошибкой вместо перезаписи чужой ревизии. Каждый экспорт передаёт Inkscape проверенную копию SVG в staging, а не живой путь workspace.

Безопасность и состояние

Проект не обещает изолировать неизвестные уязвимости нативных парсеров. Он ограничивает пути, XML, аргументы, процессы, размеры и перезаписи; текущая политика нативного ввода — trusted-local-only. Экспорт отклоняет SVG с активным содержимым или удалёнными ресурсами до запуска Inkscape; мутации resize применяют то же правило.

Инструкции по внесению вклада и инварианты находятся в AGENTS.md. Пакет остаётся приватным: публикация в npm или в registry потребует отдельного явного разрешения.

Лицензия

MIT Copyright 2026 Berrio.

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Berrio/inkscape-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server