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，并保持其运行。配套程序通过本地 TCP 连接到应用程序，默认地址为 127.0.0.1:61337。此应用程序连接不是 HTTP MCP URL。

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

此图仅描述用户工作流。

支持的 AI 编码 Agent

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

Agent 能做什么？

MCP 工具涵盖以下方面：

领域	操作
应用程序状态	检查连接状态、应用程序信息、功能和活动工作区。
SVG 检查	读取文档信息和 SVG 内容；检查 DOM 元素、选区和样式。
选择与编辑	选择元素；创建形状和路径；更改属性、填充、描边和变换。
文档操作	创建或打开文档、保存更改并导出所需内容。
重复性编辑	对齐、复制、编组、重新着色并应用受支持的路径操作。
清理	检查 SVG 清理结果，并明确请求受支持的保守修复。
预览与历史记录	渲染预览；对受支持的文档编辑使用 Undo/Redo 和事务。
资源管理器导航	检查活动文件夹、条目和选区；导航到文件夹、父级或子级，并浏览文件夹历史记录。
资源管理器文件操作	创建和重命名直接子文件夹；删除空的直接子文件夹；将选中的 SVG 文件路径复制到操作系统剪贴板；粘贴、复制和编组 SVG 文件。
资源管理器批量操作	为选中的 SVG 文件规划并应用调色板更改、图标缩放和描边更改。

可用功能取决于已安装的 IconVectors 版本。请使用 MCP 工具发现功能和 app_getCapabilities；参数的准确信息应以已安装工具的架构为准，不要根据这些摘要推测。用户界面中可用的命令，不一定都有对应的 MCP 工具。

文档 Undo 不会撤销保存、导出或资源管理器文件系统更改。创建、打开或替换文档会清除文档 Undo 历史记录。请求这些操作前，请检查操作目标和目的地。资源管理器批量操作要求先生成计划、检查计划，再应用计划返回的标识符。有关文档说明的限制，请参阅官方 MCP 指南。

样式设置器也会更新应用程序的绘图默认值。若要只编辑单个对象，请检查其当前样式，并使用明确指定元素目标的 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 时，请保留现有的服务条目。

对于此本地默认设置，无需自定义 host 参数。

请使用对应客户端的文件格式：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 上，使用 Claude Desktop 和官方 IconVectors MCPB 2.10.0 捆绑包，以及 IconVectors 2.10，打开并预览一个临时 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 问题，并附上：

• 你的 MCP 客户端和 IconVectors 版本。
• 你尝试执行的任务及复现步骤。
• 实际发生的情况和预期结果。
• 任何相关错误消息（请删除私密路径或数据）。

故障排查

如果找不到服务，请检查客户端配置位置和可执行文件路径。如果工具已显示，但 app_ping 失败，请确认 IconVectors 正在运行，并使用官方连接指南对照请求的端口与应用实际使用的端点。如果客户端尚未获取配置更改，请重启或重新加载客户端连接。

在云环境、容器或 WSL 中运行的客户端不会自动共享桌面应用的本地连接或文件系统。本仓库记录的是本地 stdio 集成，不提供远程 HTTP 服务。

有关连接、发现、版本和工作区检查，请参阅故障排查。

关于本仓库

本仓库包含公开文档、配置示例和集成指南。它不分发 IconVectors 应用、其专有实现或可独立运行的 MCP 服务。请从官方网站单独安装该应用。

这些指南遵循 IconVectors 官方 MCP 文档和客户端设置指南。请使用与你安装的应用版本相对应的文档和工具架构。

配置文件是供你控制的客户端使用的示例。阅读或克隆本仓库不会安装或启用该集成。