MCP SVG Converter

基本能力

产品定位

MCP SVG 转换器是一个基于模型上下文协议 (MCP) 的服务器，专注于将 SVG 代码转换为高质量 PNG 和 JPG 图像的工具。

核心功能

• 将 SVG 代码转换为支持透明度的高质量 PNG 图像
• 将 SVG 代码转换为可定制质量设置的高质量 JPG 图像
• 自动检测并保留原始 SVG 的尺寸
• 支持缩放到更高分辨率
• 可自定义背景颜色
• 智能路径处理，自动重定向到允许的目录
• 可配置权限的安全文件系统访问

适用场景

• 需要将 SVG 图形转换为 PNG 或 JPG 格式的场景
• 需要高质量图像输出的设计工作
• 需要批量转换 SVG 文件的工作流程
• 需要与 Claude Desktop 集成的自动化图像处理

工具列表

1. svg-to-png: 将 SVG 代码转换为支持透明度的高质量 PNG 图像
2. 参数: svgCode (必需), outputPath (必需), backgroundColor (可选), scale (可选)
3. svg-to-jpg: 将 SVG 代码转换为高质量 JPG 图像
4. 参数: svgCode (必需), outputPath (必需), backgroundColor (可选), quality (可选), scale (可选)

常见问题解答

1. Claude 没有显示 MCP 工具图标
2. 检查配置文件格式和路径是否正确
3. 确保输出目录存在且可写
4. 完全退出并重启 Claude Desktop
5. 工具执行失败
6. 确认 mcp-svg-converter 已正确安装
7. 检查输出目录权限
8. 验证 SVG 代码有效性
9. "command not found" 错误
10. 确保全局安装或正确引用 npx
11. 检查系统 PATH 设置

使用教程

使用依赖

• Node.js 16 或更高版本
• npm 或 yarn

安装教程

快速安装

npx mcp-svg-converter /path/to/allowed/directory

全局安装

npm install -g mcp-svg-converter
mcp-svg-converter /path/to/allowed/directory

从源代码安装

1. 克隆仓库

git clone https://github.com/surferdot/mcp-svg-converter.git
cd mcp-svg-converter

1. 安装依赖

npm install

1. 构建项目

npm run build

调试方式

1. 作为独立服务器运行

node build/index.js /path/to/allowed/directory1 /path/to/allowed/directory2

1. 使用 MCP Inspector 调试

npx @modelcontextprotocol/inspector npx mcp-svg-converter /path/to/allowed/directory

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。