Skip to main content
Glama

word2img-mcp

by AdolphNB

word2img-mcp

一个将 Markdown 文本渲染到 3:4 JPG 图片上的 MCP 服务,支持多种高质量渲染后端。

🚀 核心特性

  • 多后端渲染: 支持 imgkit/wkhtmltopdf、markdown-pdf、PIL 等多种渲染方案
  • 智能回退: 自动选择最佳可用后端,确保渲染成功
  • 高质量输出: 专业级别的图片渲染质量
  • 自定义样式: 丰富的样式配置选项
  • 中文支持: 完美支持中文字体和排版

📋 渲染后端

  1. imgkit/wkhtmltopdf ⭐ (推荐)
    • 最高渲染质量
    • 完整的 HTML/CSS 支持
    • 需要安装 wkhtmltopdf
  2. markdown-pdf-cli
    • 高质量 PDF 生成
    • 需要 Node.js 环境
  3. PIL 备选方案
    • 本地纯 Python 渲染
    • 无额外依赖

🛠️ MCP 工具接口

  • submit_markdown: 提交文本并生成图片
  • get_image: 根据任务ID返回图片(Base64或路径)

使用 uv 管理

准备

  • 安装 uv(若未安装):参考官方文档或使用 pipx 安装
pipx install uv

安装依赖

# 安装基础依赖 uv sync # 安装 imgkit 后端依赖(推荐) uv add imgkit markdown # 安装 wkhtmltopdf (获得最佳渲染效果) # Windows: 从 https://wkhtmltopdf.org/downloads.html 下载安装 # macOS: brew install wkhtmltopdf # Ubuntu: sudo apt-get install wkhtmltopdf

运行演示

# 运行 imgkit 后端演示 uv run python demo_imgkit.py # 运行基础演示 uv run python server.py # 生成 outputs/_sample.jpg # 测试 imgkit 后端功能 uv run python test_imgkit_backend.py

作为 MCP 服务

启动服务
# 方法 1: 使用启动脚本(推荐) uv run python start_mcp_server.py # 方法 2: 使用模块方式 uv run python -m word2img_mcp # 方法 3: 直接运行 uv run python server.py
MCP 客户端配置

Claude Desktop 配置

  1. 找到 Claude Desktop 配置文件:
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Linux: ~/.config/claude/claude_desktop_config.json
  2. 编辑配置文件,添加以下内容:
{ "mcpServers": { "word2img-mcp": { "command": "uv", "args": [ "run", "python", "-m", "word2img_mcp" ], "cwd": "/path/to/your/word2img-mcp", "env": { "UV_PROJECT_ENVIRONMENT": ".venv" } } } }

配置说明

  • command: 使用 uv 命令
  • args: 运行参数,启动 word2img_mcp 模块
  • cwd: 请修改为您的项目实际路径
  • env: 环境变量设置(可选)

Windows 完整示例

{ "mcpServers": { "word2img-mcp": { "command": "uv", "args": ["run", "python", "-m", "word2img_mcp"], "cwd": "D:\\mcpServer\\word2img-mcp" } } }

Windows uv 目录方式示例

{ "mcpServers": { "word2img-mcp": { "command": "uv", "args": [ "--directory", "D:\\mcpServer\\word2img-mcp", "run", "start_mcp_server.py" ] } } }

macOS/Linux 完整示例

{ "mcpServers": { "word2img-mcp": { "command": "uv", "args": ["run", "python", "-m", "word2img_mcp"], "cwd": "/Users/username/word2img-mcp" } } }
  1. 重启 Claude Desktop
  2. 在对话中可以使用以下工具:
    • submit_markdown: 提交 Markdown 文本生成图片
    • get_image: 获取生成的图片

💡 提示: 可以参考项目根目录的 claude_desktop_config_example.json 示例文件

验证配置

配置完成后,在 Claude Desktop 中发送消息验证:

请帮我把以下 Markdown 转换为图片: # 测试标题 这是一个 **测试** 文档,用来验证 MCP 服务是否正常工作。 - 功能测试 - 样式测试 表格测试: | 项目 | 状态 | |------|------| | MCP 配置 | ✅ | | 图片生成 | ✅ |

如果配置成功,Claude 会自动调用 MCP 服务生成图片。

🎨 样式配置

基础选项

  • 背景色: 默认纯白,支持自定义
  • 文字色: 默认黑色,支持自定义
  • 对齐方式: 支持居中、左对齐、右对齐
  • 字体: 自适应中文字体,支持自定义字体族
  • 尺寸: 默认 3:4 比例,可自定义宽高

高级功能

  • 水印: 可添加自定义水印文字
  • 阴影: 标题文字阴影效果
  • 主题: 支持亮色/暗色主题
  • 多格式: PNG、JPG、PDF 输出格式

📚 详细文档

🔧 故障排除

如果遇到渲染问题,系统会自动尝试以下后端顺序:

  1. imgkit/wkhtmltopdf (最佳质量)
  2. markdown-pdf-cli
  3. md-to-image (CLI/API)
  4. PIL 备选 (保证可用)
-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables converting Markdown text into high-quality 3:4 ratio JPG images using multiple rendering backends. Supports intelligent fallback between imgkit/wkhtmltopdf, markdown-pdf, and PIL rendering engines with customizable styling options.

  1. 🚀 核心特性
    1. 📋 渲染后端
      1. 🛠️ MCP 工具接口
        1. 使用 uv 管理
          1. 准备
          2. 安装依赖
          3. 运行演示
          4. 作为 MCP 服务
        2. 🎨 样式配置
          1. 基础选项
          2. 高级功能
        3. 📚 详细文档
          1. 🔧 故障排除

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/AdolphNB/md2img-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server