mcp-server-svgl

🚀 SVG 液 MCP 服务器

SVG 液 MCP 服务器基于 SVGL（可缩放矢量图形语言）实现，主要用于处理 SVG 内容，能提供 SVG 验证和仓库访问等功能，为 SVG 的使用和管理提供了便利。

SVGL API

✨ 主要特性

• SVG 验证：依据 SVGL 规范对 SVG 内容进行验证，确保其合规性。
• SVG 仓库访问：可浏览并检索 SVGL 仓库中的 SVG，方便获取所需资源。
• 详细错误报告：能获取按行显示的验证反馈信息，便于快速定位问题。
• Base64 编码：提供 SVG 的 Base64 格式，便于将 SVG 嵌入到其他应用中使用。

📦 安装指南

使用 Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

Docker

{
  "mcpServers": {
    "svgl": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mcp/svgl"]
    }
  }
}

NPX

{
  "mcpServers": {
    "svgl": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-svgl"]
    }
  }
}

使用 VS Code

在 VS Code 中配置，请将以下内容添加到用户设置（JSON）文件中，可以通过按 Ctrl + Shift + P 并输入“偏好设置：打开用户设置（JSON）”来完成。

Docker

{
  "mcp": {
    "servers": {
      "svgl": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/svgl"]
      }
    }
  }
}

NPX

{
  "mcp": {
    "servers": {
      "svgl": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-svgl"]
      }
    }
  }
}

手动安装

可选地，可以将其添加到工作区中的 .vscode/mcp.json 文件中。这将允许与其他用户共享配置。

⚠️ 重要提示

.vscode/mcp.json 文件中不需要 mcp 关键字。

构建

Docker 构建

docker build -t mcp/svgl:latest -f src/svgl/Dockerfile .

📚 详细文档

工具

svgl_validate

• 功能：验证 SVG 内容是否符合 SVGL 规范。
• 输入：
  • svgContent (字符串)：要验证的 SVG 内容。
• 返回：详细的验证结果，包括行号和错误信息。

svgl_list

• 功能：列出仓库中所有 SVG 及其元数据。
• 返回：一个包含以下字段的 SVG 项目数组：
  • id：唯一标识符。
  • title：SVG 标题。
  • category：SVG 类别。
  • route：SVG 路由（字符串或带有明暗主题变体的对象）。
  • url：SVG 的 URL。

svgl_get

• 功能：根据名称检索特定 SVG。
• 输入：
  • name (字符串)：要检索的 SVG 名称。
• 返回：有效的 SVG 内容，以 Base64 格式编码。

📄 许可证

此 MCP 服务器根据 MIT 许可证发布。这意味着你可以自由地使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。更多详细信息，请参阅项目存储库中的 LICENSE 文件。