CleanVector

CleanVector MCP 服务

根据提示词创作专业的 SVG 插画、图标和矢量标志，或将任意图像矢量化。

文档 · 获取 API 密钥 · MCP 注册表 · 作品集

---

CleanVector 是一款托管式 Model Context Protocol 服务。它为 Claude Code、Cursor、VS Code、Windsurf 及其他 MCP 客户端提供了大多数图像工具无法返回给 Agent 的三类内容：

• 专业 SVG 插画。 插画、图标、贴纸和吉祥物都是真正的矢量路径，并带有透明背景。没有嵌入位图，图案后方也没有白色矩形。
• 矢量标志。 输入一份简要说明，即可获得完整的品牌套件：可编辑的 SVG 标志、黑白版本、透明 PNG 导出文件，以及根据最终标志提取的调色板。
• 清晰的矢量化结果。 将 PNG、JPG 或 WebP（包括 AI 生成的图像）转换为可重新着色和缩放的 SVG。

无需安装或运行任何内容。该服务位于远程，使用 Streamable HTTP，并以 ai.cleanvector/cleanvector 名称列入官方 MCP Registry。客户端和目录无需凭据即可查看服务元数据和工具架构；但每次调用工具仍需 CleanVector API 密钥。

示例

以下三个矢量标志均由一句简短说明生成。它们是实际的 SVG 文件，存放在 examples/ 中。

Northstar 为战略工作室设计的互扣 N 字母与指南针

Kinfold 为社区平台设计的折叠丝带 K 字母

Halo 为空间计算工作室设计的两个轨道环，组成 H 字母

连接后，你可以向 Agent 提出以下请求：

为健身应用生成六个风格统一的扁平线条图标，格式为 SVG，并放入 public/icons。

为名为“Northstar”的战略工作室设计一个标志。采用几何风格，显得自信，以深蓝色为主并点缀一处珊瑚色。将 SVG 及黑白版本保存到 ./brand。

将 ./mockups/hero.png 矢量化，并在着陆页中用 SVG 替换光栅图像。

快速开始

1. 在 cleanvector.ai/app/api-keys 创建 API 密钥。Plus 和 Pro 套餐均包含 API 和 MCP 访问权限。
2. 将服务添加到你的客户端。

Claude Code

claude mcp add --transport http cleanvector https://cleanvector.ai/api/mcp \
  --header "Authorization: Bearer cv_YOUR_KEY"

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "cleanvector": {
      "url": "https://cleanvector.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cv_YOUR_KEY"
      }
    }
  }
}

VS Code（.vscode/mcp.json）

{
  "inputs": [
    {
      "id": "cleanvector_key",
      "type": "promptString",
      "description": "CleanVector API key",
      "password": true
    }
  ],
  "servers": {
    "cleanvector": {
      "type": "http",
      "url": "https://cleanvector.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:cleanvector_key}"
      }
    }
  }
}

Windsurf（~/.codeium/windsurf/mcp_config.json）

{
  "mcpServers": {
    "cleanvector": {
      "serverUrl": "https://cleanvector.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cv_YOUR_KEY"
      }
    }
  }
}

Claude Desktop 和其他仅支持 stdio 的客户端（通过 mcp-remote）

{
  "mcpServers": {
    "cleanvector": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cleanvector.ai/api/mcp",
        "--header",
        "Authorization:${CLEANVECTOR_AUTH}"
      ],
      "env": {
        "CLEANVECTOR_AUTH": "Bearer cv_YOUR_KEY"
      }
    }
  }
}

工具

工具	功能	费用
generate_illustration	根据文本提示词生成专业、可编辑的 SVG 图稿：插画、图标、贴纸和吉祥物场景。传入 mascot_id，可让同一角色在不同场景中保持一致。	4 个积分
generate_logo	生成矢量 Logo，提供原版、黑白版本、PNG 导出文件和经测量的配色方案。可接受参考图片，用于优化现有品牌形象或作为宽泛的灵感来源。	8 个积分
vectorize_image	将 PNG、JPG 或 WebP 图片（最大 5 MB，可通过 URL 或 base64 提供）转换为简洁、可编辑的 SVG。	1 或 4 个积分
wait_for_task	等待异步任务完成并返回结果。	免费
get_task	获取单个任务的状态，任务成功后还会返回下载 URL。	免费
list_tasks	列出账户最近的任务。	免费
list_mascots	列出已保存的吉祥物，其 ID 可用于让角色保持一致。	免费
download_svg	以 SVG 标记语言返回已完成的图稿。	免费
download_png	将已完成的图稿作为任意宽度的 PNG 图片返回到 Agent 的上下文中。	免费
download_logo_kit	将 3 个 SVG、3 个 PNG 和 palette.json 打包为 ZIP 文件并返回。	免费
get_account	返回当前套餐和积分余额。	免费

生成过程是异步的。典型流程为先调用 generate_illustration，然后调用 wait_for_task，最后调用 download_svg。下载和重新导出均不消耗积分。

详情

端点	https://cleanvector.ai/api/mcp
传输方式	Streamable HTTP
身份验证	可公开发现；调用工具时需要提供 Authorization: Bearer cv_... API 密钥
注册表名称	ai.cleanvector/cleanvector
访问权限	Plus 和 Pro 套餐
REST API	同一密钥也可用于 REST API，相关文档见控制面板

注册表清单位于 server.json。

输出效果

每个结果都是标准 SVG：仅包含纯 <path> 元素和填充色，不含嵌入式图片或脚本，画布透明。可在 Figma、Illustrator、Inkscape 和免费的 CleanVector SVG 编辑器中打开和编辑。请阅读了解 CleanVector 的工作原理，了解在生产环境中使用素材前需要检查的内容。

AI 生成的 Logo 不附带商标许可。在商业使用某个标记前，请先查询相关商标数据库。

支持

• 文档：cleanvector.ai/mcp
• 联系方式：cleanvector.ai/contact
• 如果这些文档或客户端配置存在问题，请在此仓库中提交 issue。

许可证

此仓库中的文档、配置示例和示例图稿均以 MIT 许可证发布。CleanVector 服务本身是托管式商业产品。