SI

shriinivas/inkmcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

79 stars 12 forks Качество 62 Тренд 15AGPL-3.0

Inkscape MCP Server - Control Inkscape через помощников AI через протокол Model Context

Обзор

Сервер Model Context Protocol (MCP), который позволяет управлять Inkscape с помощью инструкций на естественном языке. Это позволяет ИИ-ассистентам, таким как Клод, напрямую манипулировать векторной графикой в режиме реального времени. - - - Прямое манипулирование запущенными документами Inkscape - - - Связь в реальном времени - - - Создание любого элемента SVG с унифицированным синтаксисом - -️ - Семантическая организация с автоматической обработкой столкновений ID - - - Запуск произвольного кода чернил в живом контексте - -️ - Визуальная обратная связь с захватом видопорта Использует D-Bus, специфичный для Linux: кроссплатформенная поддержка возможна через гнезда TCP / названные трубы 1. Перейдите на страницу 2. Скачать inkmcp-extension.zip из последней версии 3. Извлеките его в каталог расширений Inkscape: Запуск Inkscape обычно - расширение скрыто из меню и доступно только через D-Bus. Первый раз, когда клиент ИИ подключается, он автоматически создает виртуальную среду Python в ~/.

Обзор (машинный перевод)

Сервер Model Context Protocol (MCP), который позволяет управлять Inkscape с помощью инструкций на естественном языке. Это позволяет ИИ-ассистентам, таким как Клод, напрямую манипулировать векторной графикой в режиме реального времени.

Особенности

Live Instance Control - Прямое манипулирование запущенными документами Inkscape D-Bus Интеграция - связь в режиме реального времени

  • CreationUniversal Element Creation - Создание любого элемента SVG с унифицированным синтаксисом ** Управление иерархической сценой** - Семантическая организация с автоматическим управлением столкновением ID Python Code Execution - Запустите произвольный код inkex в живом контексте Поддержка скриншота - Визуальная обратная связь с захватом порта просмотра

Поддержка платформы

В настоящее время Linux Only * * - использует D-Bus, который специфичен для Linux *** Будущее**: кросс-платформенная поддержка возможна через розетки TCP

Быстрый старт

###1.Установка (только Linux)

  1. Перейдите на страницу релизов
  2. Скачать inkmcp-extension.zip из последнего выпуска
  3. Извлеките его в каталог расширений Inkscape:

###2 Сделать скрипты исполняемыми

###3 Начать Inkscape Запуск Inkscape обычно - расширение скрыто из меню и доступно только через D-Bus.

###4.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Inkscape MCP Server

A Model Context Protocol (MCP) server that enables live control of Inkscape through natural language instructions. This allows AI assistants like Claude to directly manipulate vector graphics in real-time.

Features

  • 🎯 Live Instance Control - Direct manipulation of running Inkscape documents
  • ⚡ D-Bus Integration - Real-time communication
  • 🚀 Universal Element Creation - Create any SVG element with unified syntax
  • 🏗️ Hierarchical Scene Management - Semantic organization with automatic ID collision handling
  • 📐 Python Code Execution - Run arbitrary inkex code in live context
  • 🖼️ Screenshot Support - Visual feedback with viewport capture

Platform Support

  • ⚠️ Currently Linux Only - Uses D-Bus which is Linux-specific
  • 🔮 Future: Cross-platform support possible via TCP sockets/named pipes

Quick Start

1. Installation (Linux Only)

  1. Go to the Releases page
  2. Download inkmcp-extension.zip from the latest release
  3. Extract it to your Inkscape extensions directory:
    cd ~/.config/inkscape/extensions/
    unzip ~/Downloads/inkmcp-extension.zip
    

2. Make Scripts Executable

cd ~/.config/inkscape/extensions/inkmcp
chmod +x run_inkscape_mcp.sh inkmcpcli.py inkscape_mcp_server.py main.py

3. Start Inkscape

Launch Inkscape normally - the extension is hidden from the menu and only accessible via D-Bus.

4. Connect with AI Tools

Auto-Setup: The first time an AI client connects, it will automatically:

  • Create Python virtual environment in ~/.config/inkscape/extensions/inkmcp/venv/
  • Install all required dependencies from requirements.txt
  • Start the MCP server

No manual setup required!

Claude Code

Edit your Claude configuration file:

# ~/.claude/claude-config.json
{
  "mcpServers": {
    "inkscape": {
      "command": "/home/USERNAME/.config/inkscape/extensions/inkmcp/run_inkscape_mcp.sh"
    }
  }
}

Anthropic Claude Desktop

Update Claude desktop app settings:

{
  "mcpServers": {
    "inkscape": {
      "command": "/home/USERNAME/.config/inkscape/extensions/inkmcp/run_inkscape_mcp.sh"
    }
  }
}

Google Gemini/Codex

For Gemini, edit settings file:

# ~/.gemini/settings.json
{
  "mcpServers": {
    "inkscape-mcp": {
      "command": "/home/USERNAME/.config/inkscape/extensions/inkmcp/run_inkscape_mcp.sh"
    }
  }
}

For Codex, edit configuration:

# ~/.codex/config.toml
[mcp_servers.inkscape-mcp]
command = "/home/USERNAME/.config/inkscape/extensions/inkmcp/run_inkscape_mcp.sh"

Usage Examples

With AI Assistant (Claude Code/Gemini/etc) - Requires Running Inkscape

"In Inkscape, draw a smooth sine wave starting at the left edge in the middle of the document and apply power stroke path effect to it"
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "inkscape": { "command": "/home/USERNAME/.config/inkscape/extensions/inkmcp/run_inkscape_mcp.sh" } } }