Inkscape (inksmcp)

inksmcp

AI アシスタントが Inkscape でベクターグラフィックを作成、編集、エクスポートできる MCP サーバーです。

ポスター、図、グラフ、コミックのページについてアシスタントに説明すると、Inkscape で実際の SVG ドキュメントを作成します。寸法を測り、レイアウトを整えて、PNG または PDF にエクスポートします。ほかの場所で作成した図を開いて編集することもできます。

フィールドテスト中に、Claude が inksmcp を通じて作成しました。それぞれ13～41回のツール呼び出しで作成され、SVG は手作業で一度も編集していません。間取り図と周期表では、データの準備に短いスクリプトを使用しました。

inksmcp の特長

モデルに SVG を手書きさせる方法はアイコンには有効ですが、実際のレイアウトではうまくいきません。モデルはテキストの寸法を測れず、座標の計算を何度もやり直し、描いたものを見ることもできません。inksmcp はこうした作業をモデルから引き受けます。

• 推測ではなく、実測します。 バウンディングボックスは、テキストを含め、ドキュメント固有の単位で Inkscape 自身が測定します。
• 座標ではなく、要素間の関係を指定します。 align と layout で要素を配置します。place はタイトルの実際の字形の下にキャプションを配置します。fit_to は内容に合わせてボックスのサイズを調整します。connect は、要素を移動してもつながったままの矢印を描きます。
• データ駆動型です。 repeat はデータの各行にテンプレートを適用します（カード、タイムライン、凡例、表の行、キャラクターのポーズなど）。split はページをパネルやセルに分割します。大量のデータは JSON または CSV ファイルから読み込むため、会話を介して渡す必要はありません。
• 既存のファイルでも使えます。 ほかのツールで作成した .svg／.svgz の図を開けます。inspect find は色、種類、テキスト、シンボルを基準に要素を検索します。アイコンライブラリのシンボルも配置できます。
• 安全で、結果を確認できます。 すべてのツールは全件成功または全件失敗のいずれかです。編集結果の応答ではテキストの重なりを警告し、render_preview でエージェントが描画結果を確認できます。
• 実用的な形式で出力できます。 PNG、PDF（テキストをパスに変換するオプションあり）、プレーン SVG、EPS、EMF などに Inkscape でレンダリングします。

クイックスタート

1. Inkscape 1.x と uv をインストールします。

2. MCP クライアントにサーバーを追加します。Claude Code の場合：

   claude mcp add --scope user inkscape -- uvx inksmcp
   

   Claude Desktop、Cursor などの場合：

   { "mcpServers": { "inkscape": { "command": "uvx", "args": ["inksmcp"] } } }
   

3. 次のように依頼します：「inkscape tools を使って、土曜日の10:00に図書館の庭で開く古本交換会のA5チラシを作ってください。プレビューを見せてから、PDF をエクスポートしてください。」

各 OS とクライアントの詳細、トラブルシューティングについては、導入ガイドをご覧ください。

ツール

領域	ツール
ドキュメント	document_create、document_open、document_save、inspect（アウトライン、実際の bbox、find）、inkscape_info
要素	add_elements（rect、circle、ellipse、line、polyline、polygon、path、text、group、arrow、image、use）、update_elements、delete_elements、import_file、repeat
配置	align、layout、split、connect、z_order、move_to_layer、page_fit、page_resize
グラフ	grid（線形／対数グラフ用紙と軸）、plot（データ値で指定したデータ系列）
パス	path_operation（union、difference、intersection、combine、stroke to path、…）、run_actions（ガード付きの Inkscape アクションを直接実行）
出力	render_preview（PNG をエージェントに返します）、export

これらの組み合わせ方についてはレシピを、すべてのパラメーターについてはツールリファレンスをご覧ください。

仕組み

ドキュメントはサーバー内の lxml ツリーとして保持され、これが信頼できる情報源になります。編集はそのツリーに直接適用されます。Inkscape が必要な処理（測定、ブール演算、コネクター、レンダリング、エクスポート）はすべて、1つの永続的な inkscape --shell プロセスで実行されるため、Inkscape の起動に約 1 秒かかる代わりに、呼び出しは数ミリ秒で完了します。詳しくはアーキテクチャノートをご覧ください。

ステータス

inksmcp はベータ版（0.3）です。エージェントが実際のタスクに使用した11回の実地テストを経ています。直近のテストでは、ほかのツールで作成されたファイルを編集しました。テストは160件あり、実際の Inkscape を使って実行されます。

既知の制限：

• Inkscape 1.4.4 を使用して Windows 上で開発されています。CI は Linux と macOS でも実行されます。
• ツール一覧は、セッションごとに約 9k トークンのコンテキストを消費します。
• グラデーションとパターンは、まだスタイルキーとして作成できません。ドキュメント内にすでに存在する場合は、raw style を通じて適用できます。
• SVG 1.2 の流し込みテキストは移動できますが、編集はできません。

今後の予定はロードマップをご覧ください。

貢献

バグ報告、実地レポート（「X を依頼したところ、エージェントがここで苦労しました」など）、プルリクエストを歓迎します。CONTRIBUTING.mdをご覧ください。このプロジェクトは実験を第一に進めています。依存する Inkscape の動作はすべて experiments/ 内のスクリプトで検証され、テストで保護されています。開発ハンドブックで手法を説明しています。

ライセンス

MIT。Inkscape は GPL に基づく別のプログラムです。inksmcp は外部プロセスとして Inkscape を呼び出します。