@lucianaib/word-cloud-mcp

一个专注于从文档内容制作词云图的 MCP (Model Context Protocol) 工具，支持 PDF、Word、TXT、MD 等多种格式的智能文字提取。

功能特性

🔍 智能文字提取

• PDF 文档：支持从 PDF 文件中提取文字内容
• Word 文档：支持 .docx 和 .doc 格式的文档解析
• 文本文件：支持 .txt 纯文本文件
• Markdown：支持 .md 和 .markdown 文件，自动清理 Markdown 语法

🧹 内容净化

• 自动去除无意义的停用词（如"我"、"我们"、"的"、"了"等）
• 清理标点符号和特殊字符
• 智能分词处理，支持中英文混合文本
• 可自定义停用词列表

🎨 词云图生成

• 多种输出格式：SVG、PNG、JPG、WebP 等多种格式支持
• 多种主题：default、warm、cool、nature、business
• 灵活配置：字体大小、文字间隙、角度范围、背景色等
• 智能布局：避免文字重叠，优化视觉效果
• 高质量输出：支持高分辨率和质量调节

安装

全局安装（推荐）

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

使用方法

作为 MCP 服务器使用

1. 在你的 MCP 客户端配置中添加此服务器：

方式一：使用 npx（推荐，适用于全局安装）

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


方式二：使用 node 直接运行（适用于本地开发）

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

方式三：使用绝对路径（Windows 示例）

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

2. 重启你的 MCP 客户端（如 CodeBuddy、Cursor 等）

可用工具

1. extract_text_from_file

从文档文件中提取文字内容

参数：

• filePath (string): 文档文件的路径
• fileType (string): 文件类型 ('pdf' | 'docx' | 'txt' | 'md')

示例：

{
  "filePath": "./documents/sample.pdf",
  "fileType": "pdf"
}

2. generate_wordcloud

根据文字内容生成词云图

使用示例：

用MCP把下面的内容转换为词云图：Google AI Studio 和 Gemini API 的适用区域

content_copy


如果您在尝试打开 Google AI Studio 后进入此页面，可能是因为 Google AI Studio 在您所在的地区不可用，或者您未达到访问年龄要求（年满 18 周岁）。如需详细了解可用地区，请参阅下文；如需详细了解其他要求，请参阅服务条款。

可用区域
注意： 对于 Colab 用户 - 地区限制是根据 Colab 实例所在的地区应用，而不是根据用户所在的地区应用。您可以使用 !curl ipinfo.io
检查 Colab 实例的位置
Gemini API 和 Google AI Studio 已在以下国家和地区推出。如果您不在上述国家或地区，请尝试使用 Vertex AI 中的 Gemini API：

阿尔巴尼亚
阿尔及利亚
美属萨摩亚
安哥拉
....

参数：

• text (string): 用于生成词云图的文字内容
• theme (string, 可选): 主题色彩 (default: 'default')
• shape (string, 可选): 词云图形状 (default: 'rectangle')
• wordGap (number, 可选): 文字间隙 (default: 2)
• fontSize (object, 可选): 文字大小范围 (default: {min: 10, max: 100})
• angleRange (object, 可选): 角度范围 (default: {min: -90, max: 90})
• angleStep (number, 可选): 角度步长 (default: 45)
• outputPath (string, 可选): 输出文件路径 (default: './wordcloud.svg')
• format (string, 可选): 输出格式 ('svg' | 'png' | 'jpg' | 'jpeg' | 'webp', default: 'svg')
• backgroundColor (string, 可选): 背景颜色 (default: '#ffffff')
• quality (number, 可选): JPG/WebP 格式的质量设置 (1-100, default: 90)

示例：

{
  "text": "这是一段用于生成词云图的示例文字内容",
  "theme": "warm",
  "format": "png",
  "fontSize": {"min": 15, "max": 80},
  "backgroundColor": "#f8f9fa",
  "outputPath": "./my-wordcloud.png"
}

3. create_wordcloud_from_file

从文档文件直接生成词云图（组合操作）

参数：

• filePath (string): 文档文件的路径
• fileType (string): 文件类型
• 其他参数同 generate_wordcloud

示例：

{
  "filePath": "./documents/article.md",
  "fileType": "md",
  "theme": "nature",
  "outputPath": "./article-wordcloud.svg"
}

主题样式

default

经典彩色主题，适合大多数场景

warm

暖色调主题，营造温馨氛围

cool

冷色调主题，现代简约风格

nature

自然色彩主题，清新自然

business

商务色彩主题，专业正式

支持的文件格式

输入文件格式

| 格式 | 扩展名 | 说明 | |------|--------|------| | PDF | .pdf | 支持文字型 PDF，不支持扫描版 | | Word | .docx, .doc | Microsoft Word 文档 | | 文本 | .txt | 纯文本文件 | | Markdown | .md, .markdown | Markdown 格式文档 |

输出格式

| 格式 | 扩展名 | 特点 | 适用场景 | |------|--------|------|----------| | SVG | .svg | 矢量图形，无损缩放，文件小 | 网页展示、印刷品、需要缩放的场景 | | PNG | .png | 支持透明背景，无损压缩 | 网页、演示文稿、需要透明背景 | | JPG | .jpg/.jpeg | 有损压缩，文件小，不支持透明 | 照片处理、社交媒体分享 | | WebP | .webp | 现代格式，压缩率高，质量好 | 现代网页、移动应用 |

开发

本地开发

# 克隆项目
git clone https://github.com/lfrbmw/word-cloud-mcp.git
cd word-cloud-mcp

# 安装依赖
npm install

# 构建项目
npm run build

# 运行测试
npm test

项目结构

src/
├── index.ts                 # MCP 服务器主入口
├── extractors/
│   └── text-extractor.ts    # 文字提取器
├── utils/
│   └── content-cleaner.ts   # 内容清理器
└── wordcloud/
    └── generator.ts         # 词云图生成器

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！