ShapeWords MCP

Official

by kirrrr-2423 · JavaScript

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

io.github.kirrrr-2423/shapewords-mcp (MCP Server)

This MCP server generates ShapeWords word clouds. It can produce outputs in SVG, PNG, or JSON formats, using either plain text input or weighted words. The server is focused on transforming provided text/weights into renderable word-cloud representations.

🛠️ Key Features

ShapeWords word cloud generation
Output formats: SVG, PNG, JSON
Input types: text and weighted words

🚀 Use Cases

Create word clouds from a text corpus
Visualize weighted keywords as a word-cloud graphic or machine-readable JSON

⚡ Developer Benefits

Consistent word-cloud output across SVG/PNG/JSON
Supports both unweighted text and weighted-word inputs

⚠️ Limitations

Output and input are limited to word-cloud generation, using 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.

Add to VS Code Add to Cursor

claude_desktop_config.json

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"
      }
    }
  }
}