Skip to content
Back to search

svgforge-mcp

MCP server for SVGForge — search Iconify icons and fetch SVG / React / Vue / Svelte in Cursor, Claude, and other AI clients.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/liqiang88--svgforge-mcp/badge.svg)](/listings/liqiang88--svgforge-mcp)

HTML

<a href="/listings/liqiang88--svgforge-mcp"><img src="/api/listings/liqiang88--svgforge-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/liqiang88/svgforge-mcp.git
cd svgforge-mcp
npm install
npm run build
node dist/index.js

Or after publish:

npx -y svgforge-mcp

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 128 lines
  1. # SVGForge MCP
  2. Lightweight [Model Context Protocol](https://modelcontextprotocol.io/) bridge for [SVGForge](https://svgforge.dev). Search Iconify icons and fetch SVG / React / Vue / Svelte code from Cursor, Claude Desktop, and other MCP clients.
  3. Uses a lightweight **stdio bridge → cloud API** pattern. No local icon database.
  4. - **npm:** [svgforge-mcp](https://www.npmjs.com/package/svgforge-mcp)
  5. - **Docs:** [svgforge.dev/mcp](https://svgforge.dev/mcp)
  6. - **Repo:** [github.com/liqiang88/svgforge-mcp](https://github.com/liqiang88/svgforge-mcp)
  7. ## Install / run
  8. ```bash
  9. git clone https://github.com/liqiang88/svgforge-mcp.git
  10. cd svgforge-mcp
  11. npm install
  12. npm run build
  13. node dist/index.js
  14. ```
  15. Or after publish:
  16. ```bash
  17. npx -y svgforge-mcp
  18. ```
  19. ## Environment
  20. | Variable | Required | Default | Description |
  21. |----------|----------|---------|-------------|
  22. | `SVGForge_API_KEY` | For private tools | — | Personal token `sf_…` from Dashboard → API tokens |
  23. | `SVGForge_API_BASE` | No | `https://svgforge.dev` | API origin (no trailing slash) |
  24. | `SVGForge_MCP_ALLOW_WRITE` | No | off | Set `1` to enable `add_to_collection` |
  25. Public tools work without a key: `search_icons`, `get_icon`, `list_icon_sets`, `sanitize_svg`, `svg_to_data_uri`.
  26. ## Cursor
  27. Open **Settings → Customize → MCPs**, then add / edit the server (writes `mcp.json`).
  28. Published package:
  29. ```json
  30. {
  31. "mcpServers": {
  32. "svgforge": {
  33. "command": "npx",
  34. "args": ["-y", "svgforge-mcp"],
  35. "env": {
  36. "SVGForge_API_KEY": "sf_xxx",
  37. "SVGForge_API_BASE": "https://svgforge.dev"
  38. }
  39. }
  40. }
  41. }
  42. ```
  43. Local checkout:
  44. ```json
  45. {
  46. "mcpServers": {
  47. "svgforge": {
  48. "command": "node",
  49. "args": ["/www/wwwroot/luo-project/svgforge-mcp/dist/index.js"],
  50. "env": {
  51. "SVGForge_API_KEY": "sf_xxx",
  52. "SVGForge_API_BASE": "https://svgforge.dev"
  53. }
  54. }
  55. }
  56. }
  57. ```
  58. Replace the `args` path with your local clone’s `dist/index.js`.
  59. After saving, confirm `svgforge` shows as connected under **Customize → MCPs**. Restart MCP or Cursor if the status stays grey.
  60. Connected and calling `get_icon` in Cursor:
  61. ![Cursor MCP get_icon demo](./cursor-svgforge-mcp-geticon-demo.png)
  62. ## Claude Desktop
  63. In `claude_desktop_config.json`:
  64. ```json
  65. {
  66. "mcpServers": {
  67. "svgforge": {
  68. "command": "npx",
  69. "args": ["-y", "svgforge-mcp"],
  70. "env": {
  71. "SVGForge_API_KEY": "sf_xxx"
  72. }
  73. }
  74. }
  75. }
  76. ```
  77. ## Tools
  78. | Tool | Auth | Description |
  79. |------|------|-------------|
  80. | `search_icons` | — | Search by keyword / prefix |
  81. | `get_icon` | — | SVG or `react` / `vue` / `svelte` / `data-uri` |
  82. | `list_icon_sets` | — | Browse icon packs |
  83. | `get_my_collections` | Token | User collections |
  84. | `get_custom_icons` | Token + Pro | Private uploads |
  85. | `sanitize_svg` | — | Strip XSS-ish payloads |
  86. | `svg_to_data_uri` | — | CSS / img Data URI |
  87. | `add_to_collection` | Token + `ALLOW_WRITE=1` | Add icon to a collection |
  88. Requests send `X-SVGForge-Client: mcp` for traffic attribution.
  89. ## Token
  90. 1. Sign in at [svgforge.dev](https://svgforge.dev)
  91. 2. Open Dashboard → **API tokens**
  92. 3. Create a token (`sf_…`) — same token works for the VS Code extension
  93. ## Privacy
  94. The bridge only calls the SVGForge HTTPS API. It does not scan your disk or upload project files.
  95. ## License
  96. [MIT](./LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.