mcp

# SVGator MCP 服务器文档 SVGator MCP 服务器连接 AI 助手到 [SVGator](https://www.svgator.com)，在线 SVG 动画工具。连接后，助手可以 **浏览、检查、编辑、创建和导出** 您的 SVGator 项目，代表您执行从“列出我的项目”到“为我创建一个动画标志揭示，并导出为 Lottie 文件”等操作。 - **端点：** `https://mcp.svgator.com/mcp` - **协议：** [模型上下文协议](https://modelcontextprotocol.io) 通过可流式 HTTP - **身份验证：** OAuth 2.1（使用您的 SVGator 账户登录 - 请参阅 [快速入门](getting-started.md)） ## 您可以使用 | 功能 | 工具 | 示例提示 | | --- | --- | --- | | 浏览您的项目 | `list_projects`、`get_project`、`get_profile` | “列出我的 SVGator 项目” | | 检查项目的结构 | `get_skeleton`、`read_part` | “项目 X 中有哪些元素，哪些是动画？” | | 增量编辑项目 | `edit_part` | “把圆圈变成红色，并无限循环它的弹跳” | | 创建或替换整个项目 | `create_project`、`replace_project` | “为我创建一个新的动画加载旋转器” | | 复制、移动和重命名项目 | `duplicate_project`、`move_project` | “将项目 X 复制到我的 ‘草稿’ 文件夹” | | 管理可重用资产 | `list_assets`、`get_asset`、`create_asset`、`update_asset` | “将此图标保存为可重用资产” | | 将项目组织到文件夹中 | `list_folders`、`get_folder`、`create_folder`、`update_folder` | “创建一个 ‘营销’ 文件夹，并将此项目归档到它” | | 查询创作参考 | `describe_shape` | （由助手用于获取确切的 JSON 形状） | | 导出到可交付格式 | `export_project`、`get_render` | “将项目 X 导出为 MP4 视频” | | 获取动态设计技巧指导 | 技能资源 + 提示 | “指导一个标志揭示，然后创建它” | 服务器返回的每个项目都包含一个 `editor_url` - 一个深度链接，打开项目在 SVGator 编辑器中，因此您始终可以继续由助手留下的操作。 ## 工具 服务器暴露了 22 个工具。有关完整的参数和输出表，请参阅 [工具参考](tools.md)。 **项目** - **`list_projects`** — 列出经过身份验证的用户 SVGator 项目（最新优先），每个项目都有一个 `editor_url` 深度链接和用于分页的总计数。 - **`get_project`** — 获取单个项目摘要：标题、预览、文件夹、时间戳、画布大小、背景颜色、动画时间线和保存的导出设置。 - **`create_project`** — 从完整的项目 JSON 创建新的 SVGator 项目，由经过身份验证的用户拥有。 - **`replace_project`** — 用提供的完整项目替换现有项目的整个 JSON（在任何更改之前进行验证）。 - **`duplicate_project`** — 复制现有项目，可选地移动到不同文件夹或新标题。 - **`move_project`** — 将项目移动到不同文件夹和/或重命名。 **检查和编辑项目** - **`get_skeleton`** — 获取项目的廉价、标记轻量级结构图（仅元素树、名称和关键帧计数，永不包含值）- 编辑循环的步骤 1。 - **`read_part`** — 读取位于 ID 锚定路径的确切值或元素 - 编辑循环的步骤 2。 - **`edit_part`** — 在路径上应用一个验证的编辑（更新、插入、移动或删除）并持久化它 - 编辑循环的步骤 3。 - **`describe_shape`** — 获取一个构建块（元素或动画器）的确切 JSON 形状，以便在创作前永远不会猜测字段名称。 **资产** - **`list_assets`** — 列出经过身份验证用户的可重用资产（静态或动画 SVG 项目），最新优先。 - **`get_asset`** — 获取单个资产，包括其完整的 `data`（{document, definitions}）有效载荷。 - **`create_asset`** — 从资产文档创建新的可重用资产。 - **`update_asset`** — 替换现有资产的整个文档。 **文件夹** - **`list_folders`** — 列出经过身份验证用户的项目归档的文件夹（标签）。 - **`get_folder`** — 通过 ID 获取单个文件夹（ID、标题、时间戳）。 - **`create_folder`** — 创建一个新文件夹来组织项目。 - **`update_folder`** — 重命名现有文件夹。 **导出和账户** - **`export_project`** — 将项目导出为可交付格式（SVG、Lottie、React Native、Flutter、视频或 GIF），具有可选的每个导出重写。 - **`get_render`** — 轮询由 `export_project` 启动的栅格（视频/GIF）渲染状态，并在完成后获取签名的下载 URL。 - **`get_profile`** — 获取经过身份验证的客户资料：姓名、电子邮件、计划和团队。 ## 文档地图 | 文档 | 适用于 | 涵盖 | | --- | --- | --- | | [快速入门](getting-started.md) | 所有人 | 从 claude.ai、Claude Desktop、Claude Code 和其他 MCP 客户端连接；身份验证；隐私 | | [工具参考](tools.md) | 集成商 / 好奇者 | 每个工具，包含完整的参数和输出表 | | [编辑项目](editing.md) | 集成商 / 高级用户 | 导航 → 读取 → 编辑 → 验证循环、路径寻址、创作规则 | | [导出项目](exporting.md) | 所有人 | 格式、交付模式、导出选项、渲染轮询 | | [技能和资源](skill-and-resources.md) | 集成商 | 动态设计技能、MCP 资源和提示 | | [故障排除](troubleshooting.md) | 所有人 | 连接问题、常见错误及其含义 | ## 要求 - **SVGator 账户**（[注册](https://app.svgator.com)）。导出次数与其计划限制相同，就像在编辑器中一样。 - 要从 **claude.ai / Claude Desktop** 连接，自定义连接器需要 Claude **Pro、Max、Team 或 Enterprise** 计划。Claude Code 和其他 MCP 客户端直接连接到端点。 ## 工作原理（一段文字） 服务器是一个远程 MCP 服务器：您的 MCP 客户端（Claude 或任何支持可流式 HTTP 的客户端）连接到 `https://mcp.svgator.com/mcp`，并通过 SVGator 的常规 OAuth 登录为您登录。您的 SVGator 凭证 **仅在服务器端** - AI 模型永远不会看到您的访问令牌或密钥；它只接收工具结果（项目列表、结构图、导出文件）。工具输入根据已发布的模式进行验证，无效请求返回描述性错误，助手可以读取并纠正。