io.github.kirrrr-2423/shapewords-mcp

Official

by kirrrr-2423 · JavaScript

ShapeWords MCP

Generate ShapeWords word clouds as SVG, PNG, or JSON from text or weighted words.

Generate word clouds as SVG, PNG, or JSON from text or weighted words.

Topics

mcpmodel-context-protocolword-cloudshapewords

Install

Configuration

Environment variables

SHAPEWORDS_API_BASE_URLdefault https://shapewords.fun

ShapeWords Render API base URL. Defaults to the public ShapeWords service.

SHAPEWORDS_RENDER_API_KEYsecret

Optional bearer token for protected ShapeWords Render API deployments.

SHAPEWORDS_POLL_TIMEOUT_MSdefault 90000

Maximum time to wait for hosted render jobs, in milliseconds.

SHAPEWORDS_REQUEST_TIMEOUT_MSdefault 30000

Per-request timeout for ShapeWords API calls, in milliseconds.

claude_desktop_config.json

{
  "mcpServers": {
    "shapewords-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "shapewords-mcp@0.2.2"
      ],
      "env": {
        "SHAPEWORDS_API_BASE_URL": "https://shapewords.fun",
        "SHAPEWORDS_RENDER_API_KEY": "<YOUR_SHAPEWORDS_RENDER_API_KEY>",
        "SHAPEWORDS_POLL_TIMEOUT_MS": "90000",
        "SHAPEWORDS_REQUEST_TIMEOUT_MS": "30000"
      }
    }
  }
}