自然言語の指示によるインキスケープのライブ制御を可能にするモデルコンテキストプロトコル(MCP)サーバー。 これにより、ClaudeのようなAIアシスタントがベクトルグラフィックをリアルタイムで操作することができます。

##特徴

• ライブインッセンスコントロール** - インクスケープ文書の実行の直接操作
• ⚡D-Busインテグレーション - リアルタイム通信
• η ユニバーサル要素作成 - 統一された構文で任意のSVG要素を作成
• 🏗️ 階層的なシーン管理 - 自動IDコリジョン処理によるセマンティック組織
• 📐 Pythonコード実行 - ライブコンテキストで任意のinkexコードを実行
• ̇スクリーンショットサポート - ビューポートキャプチャによるビジュアルフィードバック

プラットフォームサポート

-****** 現在 Linux のみ** - Linux 固有の D-Bus を使用する -** 参照先**:TCPソケット/名前付きパイプによるクロスプラットフォームのサポートが可能

クイックスタート

##1. インストール(Linuxのみ)

1. リリースページへ
2. 最新のリリースから[inkmcp-extension.zipをダウンロード 3。 Inkscape拡張ディレクトリにそれを抽出します。

##2. スクリプトを実行可能にする

##3. インクスケープを開始 Inkscapeを正常に起動 - 拡張はメニューから隠され、D-Bus経由でのみアクセス可能です。

##4.

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"