SVG to PNG MCP Server

[](https://mseep.ai/app/longbowzz-svg2png-mcp) # SVG to PNG MCP Server [](https://smithery.ai/server/@longbowzz/svg2png_mcp) 这是一个基于Model Context Protocol (MCP)的SVG转PNG工具服务器。 ## 功能特点 - 将SVG代码转换为PNG图片 - 支持指定工作目录 - 基于MCP协议，可与其他MCP客户端集成 ## SVG转PNG方案说明 目前支持两种SVG转PNG的转换方案： 1. CairoSVG方案（当前使用） - 使用`cairosvg`库进行转换 - 优点： - 转换速度快 - 依赖少，安装简单 - 适合简单的SVG图形转换 - 缺点： - 中文字体支持需要特殊处理 - 某些复杂SVG特性支持有限 2. Inkscape方案（备选） - 使用Inkscape命令行工具进行转换 - 优点： - 完整支持SVG所有特性 - 更好的字体渲染支持 - 转换效果更准确 - 缺点： - 需要安装Inkscape软件 - 转换速度相对较慢 - 系统依赖较多 注意：当前版本默认使用CairoSVG方案，如果遇到字体渲染问题或复杂SVG转换问题，可以考虑切换到Inkscape方案。 ## 项目结构 ``` svg2png_mcp/ ├── src/ │ ├── server.py # MCP服务器实现 │ ├── svg2png.py # SVG转PNG的业务逻辑 │ └── test_client.py # 测试客户端 ├── servers_config.example.json # MCP服务器配置示例 └── requirements.txt # 依赖文件 ``` ## 安装 ### Installing via Smithery To install SVG to PNG MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@longbowzz/svg2png_mcp): ```bash npx -y @smithery/cli install @longbowzz/svg2png_mcp --client claude ``` 1. 创建并激活虚拟环境： ```bash # 创建虚拟环境 python -m venv venv # 激活虚拟环境 # 在 macOS/Linux 上： source venv/bin/activate # 在 Windows 上： .\venv\Scripts\activate ``` 2. 安装依赖： ```bash pip install -r requirements.txt ``` ## 配置 1. 复制配置文件示例： ```bash cp servers_config.example.json servers_config.json ``` 2. 编辑 `servers_config.json`，**必须使用绝对路径**： ```json { "mcpServers": { "svg2png": { "command": "/absolute/path/to/venv/bin/python", "args": [ "/absolute/path/to/svg2png_mcp/src/server.py" ] } } } ``` ⚠️ **重要说明**： - `command` 必须是虚拟环境中 Python 解释器的**绝对路径** - `args` 中的 `server.py` 路径必须是**绝对路径** - 这是为了确保其他 MCP 客户端能够正确找到并启动服务器 获取路径的方法： ```bash # 获取Python解释器的绝对路径（在虚拟环境中运行） which python # macOS/Linux where python # Windows # 获取项目根目录的绝对路径 pwd # macOS/Linux cd # Windows ``` 示例（macOS/Linux）： ```json { "mcpServers": { "svg2png": { "command": "/Users/username/projects/svg2png_mcp/venv/bin/python", "args": [ "/Users/username/projects/svg2png_mcp/src/server.py" ] } } } ``` 示例（Windows）： ```json { "mcpServers": { "svg2png": { "command": "C:\\Users\\username\\projects\\svg2png_mcp\\venv\\Scripts\\python.exe", "args": [ "C:\\Users\\username\\projects\\svg2png_mcp\\src\\server.py" ] } } } ``` ## 使用方法 运行测试客户端： ```bash # 确保虚拟环境已激活 source venv/bin/activate # macOS/Linux # 运行客户端 python src/test_client.py ``` 如果运行正常，将在test_output目录生成一张名为output.png的图片。 将servers_config.json中的内容填入Cursor、Claude desktop等MCP客户端即可使用。 注意： - MCP客户端会自动根据 `servers_config.json` 中的配置启动服务器 - 确保 `servers_config.json` 中使用了正确的绝对路径 - 确保在运行客户端时已激活虚拟环境 ## 技术实现 ### 服务器架构 - 使用 FastMCP 框架实现 MCP 服务器 - 提供 `svg_to_png` 工具接口 - 支持异步操作和错误处理 ### 核心功能 - SVG 到 PNG 的转换使用 cairosvg 库 - 支持自定义工作目录 - 提供完整的错误处理和日志记录 ### 客户端集成 - 支持标准 MCP 客户端接入 - 提供测试客户端示例 - 支持工具发现和异步调用 ## 依赖 - mcp：MCP 协议实现 - cairosvg：SVG 转换核心库 - Pillow：图像处理支持