inkscape-mcp

stdio を介したローカル MCP サーバーで、Inkscape を限定的にヘッドレス制御するためのものです。このプレアルファ版は、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、および 1 つ以上の --workspace-root 引数で起動するよう設定してください。ドキュメントツールから参照できるのはこれらのディレクトリだけです。

現在の MCP ツール

変更とエクスポートには expectedRevision が必要です。読み取りとコミットの間にファイルが変更された場合、他人のリビジョンを上書きする代わりに操作は失敗します。すべてのエクスポートは、ワークスペースの実パスではなく、検証済みの SVG コピーを staging で Inkscape に渡します。

セキュリティとステータス

このプロジェクトは、ネイティブパーサーの未知の脆弱性を隔離することを約束しません。パス、XML、引数、プロセス、サイズ、上書きを制限します。現在のネイティブ入力ポリシーは trusted-local-only です。エクスポートは Inkscape を起動する前に、アクティブコンテンツやリモートリソースを含む SVG を拒否します。リサイズの変更にも同じルールが適用されます。

貢献方法の指示と不変条件は AGENTS.md にあります。パッケージは引き続きプライベートです。npm やレジストリへの公開には、別途明示的な承認が必要です。

ライセンス

MIT Copyright 2026 Berrio.