SVG Converter

🚀 MCP SVG 使用指南

MCP SVG 是一款強大的工具，可將 SVG 代碼轉換為高質量的 PNG 和 JPG 圖像，為用戶提供便捷的圖像轉換服務。

🚀 快速開始

安裝與配置

安裝

1. 使用 npm 安裝：

npm install -g mcp-svg-converter

2. 全局安裝檢查： 確保 node_modules 目錄存在於你的用戶主目錄下，例如：/Users/yourusername/node_modules

配置

創建配置文件

在項目根目錄或任意位置創建一個名為 mcp-config.json 的文件，並添加以下內容：

{
  "tools": {
    "svg-converter": {
      "command": "npx",
      "args": [
        "mcp-svg-converter"
      ],
      "allowedOutputPaths": [
        "/Users/yourusername/Desktop/svg-output",
        "/Users/yourusername/Documents/svg-images"
      ]
    }
  }
}

配置說明

• command：指定執行命令（如 npx 或直接使用可執行文件路徑）
• args：命令的參數列表，依次為工具名稱和允許的輸出目錄
• allowedOutputPaths：允許寫入的文件夾路徑

啟動服務器

在終端中運行以下命令啟動 MCP 服務器：

npx mcp-svg-converter /Users/yourusername/Desktop/svg-output /Users/yourusername/Documents/svg-images

參數說明

• 輸出目錄：指定允許寫入的文件夾路徑

✨ 主要特性

支持格式

• SVG 轉 PNG
• SVG 轉 JPG

高級功能

• 自定義背景顏色
• 圖像縮放
• JPEG 質量控制
• 自動路徑重定向

💻 使用示例

基礎用法

{
  "svgCode": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 200 200\">\n  <rect width=\"200\" height=\"200\" fill=\"#f0f0f0\" />\n  <circle cx=\"100\" cy=\"100\" r=\"80\" fill=\"#ff6b6b\" />\n  <path d=\"M100 50 L130 150 L70 150 Z\" fill=\"white\" />\n</svg>",
  "outputPath": "/Users/yourusername/Desktop/output.png",
  "backgroundColor": "#ffffff",
  "scale": 2
}

高級用法

{
  "svgCode": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 200 200\">\n  <rect width=\"200\" height=\"200\" fill=\"#f0f0f0\" />\n  <circle cx=\"100\" cy=\"100\" r=\"80\" fill=\"#ff6b6b\" />\n  <path d=\"M100 50 L130 150 L70 150 Z\" fill=\"white\" />\n</svg>",
  "outputPath": "/Users/yourusername/Desktop/output.jpg",
  "quality": 90
}

📚 詳細文檔

參數說明

公共參數

特定格式參數

🔧 技術細節

故障排除

常見問題

1. 權限問題：確保輸出目錄有寫入權限。
2. 路徑錯誤：檢查輸出路徑是否正確。

解決方法

chmod 755 /Users/yourusername/Desktop/svg-output

工具檢查

MCP 提供了一個檢查工具來驗證配置文件和服務器狀態：

npx mcp-inspector

檢查結果示例

{
  "status": "success",
  "message": "所有配置參數均有效"
}

更多信息

如需更多幫助或深入文檔，請訪問 MCP 官方網站。