knowledge-base/mcp-usage.md

MCP Server Usage Guide

Connecting to Any2SVG MCP Server

Local Development

When running locally, the MCP server is available at:

http://localhost:7860/gradio_api/mcp/sse

Hugging Face Spaces

When deployed to HF Spaces:

https://YOUR-USERNAME-any2svg.hf.space/gradio_api/mcp/sse

Client Configuration

Claude Desktop / Cursor / Cline

Add to your MCP client config:

{
  "mcpServers": {
    "any2svg": {
      "url": "http://localhost:7860/gradio_api/mcp/sse"
    }
  }
}

For SSE-incompatible clients (e.g., Claude Desktop)

Use mcp-remote:

{
  "mcpServers": {
    "any2svg": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:7860/gradio_api/mcp/sse"
      ]
    }
  }
}

Available Tools

image_to_svg

Convert any raster image to SVG vector graphics.

Parameters:

• image (required): Image URL or base64 data
• color_mode (optional): "color" or "binary" (default: "color")
• filter_speckle (optional): 1-100 (default: 4)
• color_precision (optional): 1-8 (default: 6)

Returns:

• svg_file_path: Path to saved SVG file
• svg_content: SVG markup string

Environment Variables

• SVG_OUTPUT_DIR: Directory for saved SVG files (default: ./output)
• GRADIO_MCP_SERVER: Set to true to enable MCP mode