Axialis IconVectors MCP

Axialis IconVectors MCP

このリポジトリには、Axialis IconVectors で利用できる MCP 統合のドキュメントと設定例が含まれています。IconVectors アプリケーションのソースコードは含まれていません。

はじめに

Axialis IconVectors を使うと、MCP 対応のローカルコーディングクライアントから、実行中のデスクトップエディターで開いている SVG を調べ、依頼された編集を行い、結果をプレビューしてエクスポートできます。クライアントは、提供されている MCP コンパニオンを介して、実際の IconVectors ドキュメントを操作します。

IconVectors はプロプライエタリソフトウェアであり、別途インストールする必要があります。このドキュメントリポジトリの名前は iconvectors-mcp です。

Windows では、MCP クライアントは IconVectorsMcp.exe を独立したローカルプロセスとして起動し、stdio 経由で通信します。まず IconVectors を通常どおり起動し、実行したままにしてください。コンパニオンは、デフォルトで 127.0.0.1:61337 のローカル TCP 経由でアプリケーションに接続します。このアプリケーション接続は HTTP MCP URL ではありません。

AI coding agent
       |
       v
Model Context Protocol (local stdio)
       |
       v
Axialis IconVectors
       |
       v
SVG document

この図はユーザーのワークフローのみを示しています。

対応する AI コーディングエージェント

IconVectors の公式ドキュメントでは、以下の 8 つのクライアントすべてについて、Windows でのセットアップ手順を案内しています。各クライアントの簡潔な例には、メンテナンスされている公式ガイドへのリンク、設定場所、接続確認の方法が含まれています。

クライアント	設定ガイド
OpenAI Codex	Codex
Claude Code	Claude Code
Cursor	Cursor
VS Code / GitHub Copilot	VS Code / GitHub Copilot
Gemini CLI	Gemini CLI
Kiro	Kiro
Cline	Cline
GitHub Copilot CLI	GitHub Copilot CLI

エージェントでできること

MCP ツールは、以下の領域をカバーします。

領域	操作
アプリケーションの状態	接続状態、アプリケーション情報、機能、アクティブなワークスペースを確認します。
SVG の調査	ドキュメント情報と SVG コンテンツを読み取り、DOM 要素、選択範囲、スタイルを調べます。
選択と編集	要素を選択し、図形やパスを作成して、属性、塗り、線、変換を変更します。
ドキュメント操作	ドキュメントの作成やオープン、変更の保存、依頼された出力のエクスポートを行います。
繰り返し編集	整列、複製、グループ化、色の変更、対応するパス操作を行います。
クリーンアップ	SVG のクリーンアップで検出された項目を確認し、対応する保守的な修正を明示的に依頼します。
プレビューと履歴	プレビューをレンダリングし、対応するドキュメント編集に Undo／Redo とトランザクションを使用します。
エクスプローラーでの移動	アクティブなフォルダー、項目、選択範囲を調べ、フォルダー、親フォルダー、子フォルダーへ移動し、フォルダー履歴をたどります。
エクスプローラーのファイル操作	直接の子フォルダーを作成・名前変更し、空の直接の子フォルダーを削除します。選択した SVG ファイルのパスを OS のクリップボードにコピーし、SVG ファイルを貼り付け、複製、グループ化します。
エクスプローラーの一括操作	選択した SVG ファイルに対するパレット変更、アイコンのサイズ変更、線の変更を計画して適用します。

利用できる機能は、インストールされている IconVectors のバージョンによって異なります。MCP ツールの検出と app_getCapabilities を使用してください。正確な引数は、これらの概要から推測せず、インストール済みツールのスキーマで確認してください。ユーザーインターフェイスで操作できるからといって、MCP ツールでも利用できるとは限りません。

ドキュメントの Undo では、保存／エクスポートやエクスプローラーのファイルシステム変更を元に戻せません。ドキュメントを作成、オープン、置換すると、ドキュメントの Undo 履歴は消去されます。これらの操作を依頼する前に、対象と保存先を確認してください。エクスプローラーの一括操作では、計画を作成し、その内容を確認してから、返された識別子を使って適用する必要があります。記載されている制限については、公式 MCP ガイドを参照してください。

スタイル設定ツールは、アプリケーションの描画デフォルトも更新します。1 つのオブジェクトだけを対象に編集する場合は、現在のスタイルを調べ、明示的な要素ターゲットを指定して DOM 属性またはスタイルのパッチを使用してください。

要件

• IconVectors がインストールされ、実行中であり、対応する MCP 実行ファイルがあること。
• 同じマシン上で stdio プロセスを起動できるローカル MCP クライアント。
• クライアントとその MCP 統合を使用する権限。組織のポリシーによって制限される場合があります。
• 正しい実行ファイルのパスとアプリケーションのポート。
• 保存とエクスポートには、有効な IconVectors の試用版またはライセンスが必要です。30 日間の試用版はすべての機能を利用できます。有効期限が切れると、保存とエクスポートにはアクティベーションが必要です。

現在の Windows、macOS、Linux 向けリリースと要件については、公式ダウンロードページを参照してください。このリポジトリの設定例は、ネイティブ Windows との統合を対象としています。

はじめに

ネイティブ Windows の場合：

1. 公式ダウンロードページから IconVectors をインストールします。
2. 通常どおり IconVectors を起動し、開いたままにします。
3. インストールディレクトリに IconVectorsMcp.exe があることを確認します。
4. お使いのクライアント向けのガイドに従ってサーバーを追加します。
5. クライアントに MCP プロセスを起動させます。そのプロセスからツールが検出されます。
6. 以下の読み取り専用の最初のテストを実行します。
7. 編集を依頼する前に、対象となるアプリケーション、ワークスペース、ドキュメントが正しいことを確認します。

最初のテスト：開いている SVG を確認する

IconVectors の Editor で自分で SVG を開き、クライアントに次のように依頼します。

Use IconVectors MCP to call app_ping, app_getInfo, app_getCapabilities,
and app_get_workspace. Confirm this is the intended Editor document.
Then call document_getInfo, selection_get, and document_getSvg to report
the canvas size, selected elements, and SVG structure. Do not change,
save, export, or create any files.

Editor のドキュメントが開いていない場合は、状態の確認までで止め、IconVectors でドキュメントを開いてください。ツールカタログとアプリケーションの機能は、インストールされているバージョンによって異なります。編集を依頼する前に、接続されているツールを確認してください。

クライアントの設定

各ガイドでは、次の標準的な Windows インストールパスを使用しています。

C:\Program Files\Axialis\IconVectors\IconVectorsMcp.exe

各例では、ドキュメントに記載されているデフォルトのアプリケーションポートを明示的に指定しています。

["--port", "61337"]

インストール先が異なる場合は、実行ファイルのパスを置き換えてください。アプリケーションの Options/McpPort 設定を変更した場合は、クライアント設定でも同じポートを指定してください。2.10 以降では、指定したポートが使用中の場合、対応するコンパニオンがループバックの自動フォールバック先を検出できます。詳しくは公式接続ガイドを参照してください。IconVectors を追加するときは、既存のサーバーエントリをそのまま保持してください。

このローカルのデフォルト設定では、カスタムのホスト引数は必要ありません。

クライアント固有のファイル形式を使用してください。Codex は TOML、VS Code は servers JSON オブジェクトを使用し、その他の複数のクライアントは mcpServers を使用します。インストール済みの iconvectors-mcp-tools.json はツールのリファレンスであり、クライアント接続設定ではありません。

ワークフローの例

読み取り専用の最初のテストから始めます。

結果を確認した後、範囲を限定して変更を依頼します。

In the current Editor document, inspect the selected object's current style.
Use dom_setStyle with its explicit target to patch its fill to #2563EB.
Leave other properties and drawing defaults unchanged. Reinspect the object
and show a preview. Do not save yet.

最後に、選択したローカルの保存先への保存またはエクスポートを明示的に依頼します。構造を変更した後は、オブジェクトの対象を再確認してください。履歴トランザクションは、ツールから返されたトランザクション識別子を使い、互換性のあるドキュメント編集に限って使用してください。

Claude Desktop + IconVectors MCP の手順

検証済みの 40 秒の手順動画を見るか、セットアップ、ワークフロー、検証済みのサンプルファイルをお読みください。

Windows では、IconVectors 2.10 とともに Claude Desktop および公式 IconVectors MCPB 2.10.0 バンドルを使用し、一時的な SVG を開いてプレビューし、線の色を変更して、背景を透明にした 16／24／32px の PNG をエクスポートしました。これは完了済みの実行内容を解説するものであり、中断のないライブ実行ではありません。実行にはタイムアウトからの復旧と、エクスポートサイズの修正が含まれていました。

ピクセル単位でエクスポートする場合は、size: { mode: "pixels", widthPx: 16, heightPx: 16, keepAspectRatio: false } を使用し、ほかの出力では width／height の値をそれぞれ 24 と 32 に設定してください。サンプルガイドでは、新しい出力先パス、確認された 16px の制限、サードパーティの帰属表示について説明しています。

ドキュメント

• MCP 公式統合ガイド
• クライアント設定ガイド
• トラブルシューティング
• IconVectors 製品情報
• 公式ダウンロード

インストール済みのバージョンに付属するコマンドリファレンスとツールスキーマを使用してください。利用できる場合は、Help > Open MCP Files Folder を選択すると、インストール済みのヘルプドキュメントが開きます。

フィードバックとバグ報告

問題が発生した場合や必要な機能がある場合は、GitHub の issue を作成し、次の情報を記載してください。

• 使用している MCP クライアントと IconVectors のバージョン。
• 実行しようとしたタスクと再現手順。
• 実際に起きたことと、期待していたこと。
• 関連するエラーメッセージ。非公開のパスやデータは削除してください。

トラブルシューティング

サーバーが見つからない場合は、クライアントの設定場所と実行ファイルのパスを確認してください。ツールは表示されるものの app_ping が失敗する場合は、IconVectors が起動していることを確認し、公式接続ガイドを参照して、要求されたポートとアプリケーションの実際のエンドポイントを比較してください。設定変更が反映されていない場合は、クライアント接続を再起動または再読み込みしてください。

クラウド環境、コンテナー、または WSL で実行中のクライアントは、デスクトップアプリケーションのローカル接続やファイルシステムを自動的に共有しません。このリポジトリでは、ローカルの stdio 統合について説明しており、リモート HTTP サービスは提供していません。

接続、検出、バージョン、ワークスペースの確認については、トラブルシューティングを参照してください。

このリポジトリについて

このリポジトリには、公開ドキュメント、設定例、統合ガイドが含まれています。IconVectors アプリケーション、そのプロプライエタリな実装、または単独で実行可能な MCP サーバーは配布していません。アプリケーションは公式ウェブサイトから別途インストールしてください。

各ガイドは、IconVectors の公式 MCP ドキュメントとクライアント設定ガイドに沿っています。インストール済みのアプリケーションのバージョンに対応するドキュメントとツールスキーマを使用してください。

設定ファイルは、管理下にあるクライアント向けの例です。このリポジトリを閲覧またはクローンしても、統合はインストールまたは有効化されません。