@opensvg/mcp

Model Context Protocol (MCP) server for OpenSVG. Connect 322,000+ vector icons directly to Cursor IDE, Claude Desktop, Antigravity, and Windsurf.

⚡ Quickstart

Cursor IDE Setup

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "opensvg": {
      "command": "npx",
      "args": ["-y", "@opensvg/mcp"],
      "env": {
        "OPENSVG_API_KEY": "osvg_live_YOUR_API_KEY_HERE"
      }
    }
  }
}

Claude Desktop Setup

Add to claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "opensvg": {
      "command": "npx",
      "args": ["-y", "@opensvg/mcp"],
      "env": {
        "OPENSVG_API_KEY": "osvg_live_YOUR_API_KEY_HERE"
      }
    }
  }
}

Related MCP server: Iconify MCP Server

🛠️ Available Tools

1. search_icons: Typo-tolerant search across 320,000+ icons by keyword, tags, collection, and category.

2. get_icon: Fetch vector code in raw SVG, React JSX, Vue 3, Svelte, or Data URI formats.

3. list_collections: Discover available icon packs (Lucide, Heroicons, Phosphor, Tabler, etc.).

4. sanitize_svg: Strip malicious scripts, event listeners, and XML bomb vulnerabilities.

5. svg_to_data_uri: Generate URL-encoded CSS background-image or HTML img src snippets.

6. get_my_collections: Access private custom collections (OpenSVG Pro).

🔑 Authentication & Quotas

Get your personal API key from the OpenSVG Dashboard.

• Guest (No Key): 5 requests / min

• Free Account: 30 requests / min & 300 requests / day

• Pro Account: 120 requests / min & 5,000 requests / day

📄 License

MIT © OpenSVG