Word Cloud

You can run a word cloud generator as an MCP server to extract text from documents, clean the content, and render vivid word clouds in various formats. This server handles formats like PDF, Word, TXT, and Markdown, with flexible styling and output options to fit your workflows.

How to use

To use this MCP server, add it to your MCP client configuration and start it alongside other MCP services. You can run it locally during development or reference a remote instance if you prefer.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine.

Install the Word Cloud MCP globally so you can invoke it from any project.

npm install -g @lucianaib/word-cloud-mcp

As MCP servers using stdio (local execution)

You can run the server locally via three common methods. Each method exposes the same MCP server functionality but uses a different command invocation. Copy the appropriate block into your MCP client configuration.

{
  "mcpServers": {
    "wordcloud": {
      "command": "npx",
      "args": ["@lucianaib/word-cloud-mcp"]
    }
  }
}

{
  "mcpServers": {
    "wordcloud": {
      "command": "node",
      "args": ["path/to/word-cloud-mcp/dist/index.js"],
      "cwd": "path/to/word-cloud-mcp"
    }
  }
}

{
  "mcpServers": {
    "wordcloud": {
      "command": "node",
      "args": ["D:/word-cloud-mcp/dist/index.js"],
      "cwd": "D:/word-cloud-mcp"
    }
  }
}

Configuration notes

If you install globally, you can reference the server from your MCP client using the npx-based configuration. If you are developing locally, point to the built distribution with the node-based configuration. No authentication is shown in examples, so use placeholders if your environment requires credentials.

Additional configuration topics

Supported input and output formats are described in the server's capabilities. You can customize themes, shapes, font sizes, spacing, and background color when generating word clouds, and choose the output format such as SVG, PNG, JPG, or WebP.

Know what you can do with the tools

The server exposes a set of tools to work with text and word clouds. You can extract text from files, generate word clouds from text, and create word clouds directly from documents.

Available tools

extract_text_from_file

Extracts text content from a document file, supporting PDF, docx/doc, txt, and md formats.

generate_wordcloud

Creates a word cloud image from the provided text with customizable theme, shape, font size, spacing, angles, and output format.

create_wordcloud_from_file

Generates a word cloud directly from a document file by combining text extraction and cloud generation in a single operation.