svg-converter-mcp

A lightweight MCP server for converting SVG images to PNG and JPEG formats.

Overview

svg-converter-mcp is a lightweight MCP (Model Context Protocol) server designed for personal use that converts SVG vector images to raster image formats (PNG/JPEG). It specializes only in conversion processing and does not perform file operations, making it lightweight and resource-efficient.

Features

• Convert SVG images to PNG or JPEG formats
• Configure output options (dimensions, quality, etc.)
• Lightweight implementation with minimal memory usage
• Communicates via standard input/output (stdio) without using HTTP ports
• Can be integrated with other services such as secure-filesystem-server

Prerequisites

• Node.js (v14 or later recommended)
• npm or yarn

Installation

# Clone the repository
git clone https://github.com/tokida/svg-converter-mcp.git
cd svg-converter-mcp

# Install dependencies
npm install

# Build
npm run build

Dependencies

• @modelcontextprotocol/sdk: MCP server framework
• sharp: Image processing library for Node.js

Adding to Claude Desktop

Add the following to the configuration file (typically ~/.config/claude/config.json):

{
  "mcpServers": {
    "svg-converter": {
      "command": "npx",
      "args": [
        "-y",
        "svg-converter-mcp"
      ]
    }
  }
}

Usage

Converting SVG to PNG/JPEG

use convert_svg

You can specify parameters such as:

• svgData: SVG content (string)
• format: Output format ("png" or "jpeg"/"jpg")
• width: Output width (in pixels, optional)
• height: Output height (in pixels, optional)
• quality: Output quality (0-100, JPEG only, optional)

Getting Converter Information

use get_converter_info

Using with secure-filesystem-server

This service can be used with secure-filesystem-server as follows:

1. Convert SVG data with svg-converter-mcp
2. Retrieve the converted binary data
3. Save the binary data as a file using secure-filesystem-server
4. Reference the saved file from secure-filesystem-server as needed

Performance Considerations

• Designed for personal use with minimal resource consumption
• Large SVGs may require more memory
• Faster startup compared to HTTP servers due to the use of standard input/output

Security

• Input validation is implemented to prevent potential vulnerabilities
• SVG size is limited to prevent memory exhaustion attacks
• Does not directly access the file system
• Does not open network ports, preventing network-related attacks

Development

# Build
npm run build

# Run in development mode
npm run dev

# Run tests
npm test

License

MIT

Contributing

Contributions are welcome! Feel free to submit pull requests.