Vectorize

Vectorize — MCP 设置

通过我们托管的 Model Context Protocol (MCP) 服务，将你的 AI 助手连接到 Vectorize——将栅格图像（PNG、JPG、…）描摹为矢量图：SVG、PDF、EPS 或 DXF。使用 dudko.dev 账户登录一次即可；无需粘贴 API 密钥。

该服务是 Vectorize HTTP API 的入口，并非描摹器：图像不会经过模型或服务。助手会请求相应操作，并在图像所在的位置执行。

• 服务： vectorize
• 传输方式： streamable HTTP
• URL： https://vectorize.dudko.dev/mcp
• 身份验证： 通过 auth.dudko.dev 使用 OAuth 2.1——系统会提示你登录。

你可以做什么

三个工具，全部免费：

工具	功能
api_access	了解 Vectorize API 的工作方式。
trace_options	查看预设（照片、海报、黑白）、选项和限制。
api_request	检查描摹选项并返回准确的请求——URL、标头、curl 命令，以及适用于你账户的 15 分钟凭据。输出：svg、pdf、eps、dxf 或 json。

---

在 Claude Code 中安装（插件）

/plugin marketplace add dudko-dev/vectorize-mcp-setup
/plugin install vectorize@vectorize
/reload-plugins

然后运行 /mcp，并按提示完成登录。

不想使用 marketplace？直接添加服务：

claude mcp add --transport http vectorize https://vectorize.dudko.dev/mcp

---

从其他客户端连接

远程 URL 和登录方式相同——只有配置位置不同。

Claude Desktop / claude.ai connectors

1. 打开 Settings → Connectors → Add custom connector。
2. 名称：Vectorize
3. URL：https://vectorize.dudko.dev/mcp
4. 保存，然后连接并按提示登录。

Cursor

~/.cursor/mcp.json（全局）或 .cursor/mcp.json（每个项目）：

{
  "mcpServers": {
    "vectorize": {
      "url": "https://vectorize.dudko.dev/mcp"
    }
  }
}

VS Code（GitHub Copilot / MCP）和其他客户端

{
  "servers": {
    "vectorize": {
      "type": "http",
      "url": "https://vectorize.dudko.dev/mcp"
    }
  }
}

---

身份验证

该服务是 OAuth 2.1 资源服务。首次调用会返回 401，并在 WWW-Authenticate 标头中提供其受保护资源元数据的地址：

• https://vectorize.dudko.dev/.well-known/oauth-protected-resource/mcp

其中指定 https://auth.dudko.dev 为授权服务（范围 usage）。符合规范的 MCP 客户端会自动发现这些信息——你只需提供服务 URL，并使用 dudko.dev 账户登录。令牌绑定到受众 https://vectorize.dudko.dev/mcp，在其他任何位置都会被拒绝。

服务本身不存储文件或内容：其工具会返回一条可直接运行的 HTTP 请求，并附带适用于你登录账户的短期凭据（有效期 15 分钟，且仅适用于此 API）。你的助手会在文件所在的位置运行该请求，API 则直接向调用方返回结果。每次请求都会像其他 API 调用一样计入你账户的套餐；MCP 工具本身免费。

---

故障排除

• 401 / 再次提示登录——令牌已过期；请在客户端重新连接。
• “套餐额度已用尽” / 402——你账户的描摹额度已用完；重试无济于事。请查看 https://auth.dudko.dev/account。
• 没有显示工具——检查客户端是否已完成登录（Claude Code 中的 /mcp 会显示 已连接）。

支持

• 网站：https://vectorize.dudko.dev
• API 文档：https://vectorize.dudko.dev/api
• 面向 Agent：https://vectorize.dudko.dev/llms.txt
• 联系方式：[email protected]