Converts Markdown text into high-quality 3:4 aspect ratio JPG images with support for multiple rendering backends, custom styling, and Chinese fonts
word2img-mcp
一个将 Markdown 文本渲染到 3:4 JPG 图片上的 MCP 服务,支持多种高质量渲染后端。
🚀 核心特性
- 多后端渲染: 支持 imgkit/wkhtmltopdf、markdown-pdf、PIL 等多种渲染方案
- 智能回退: 自动选择最佳可用后端,确保渲染成功
- 高质量输出: 专业级别的图片渲染质量
- 自定义样式: 丰富的样式配置选项
- 中文支持: 完美支持中文字体和排版
📋 渲染后端
- imgkit/wkhtmltopdf ⭐ (推荐)
- 最高渲染质量
- 完整的 HTML/CSS 支持
- 需要安装 wkhtmltopdf
- markdown-pdf-cli
- 高质量 PDF 生成
- 需要 Node.js 环境
- PIL 备选方案
- 本地纯 Python 渲染
- 无额外依赖
🛠️ MCP 工具接口
- submit_markdown: 提交文本并生成图片
- get_image: 根据任务ID返回图片(Base64或路径)
使用 uv 管理
准备
- 安装 uv(若未安装):参考官方文档或使用 pipx 安装
安装依赖
运行演示
作为 MCP 服务
启动服务
MCP 客户端配置
Claude Desktop 配置
- 找到 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
- Windows:
- 编辑配置文件,添加以下内容:
配置说明:
command
: 使用uv
命令args
: 运行参数,启动 word2img_mcp 模块cwd
: 请修改为您的项目实际路径env
: 环境变量设置(可选)
Windows 完整示例:
Windows uv 目录方式示例:
macOS/Linux 完整示例:
- 重启 Claude Desktop
- 在对话中可以使用以下工具:
submit_markdown
: 提交 Markdown 文本生成图片get_image
: 获取生成的图片
💡 提示: 可以参考项目根目录的
claude_desktop_config_example.json
示例文件
验证配置
配置完成后,在 Claude Desktop 中发送消息验证:
如果配置成功,Claude 会自动调用 MCP 服务生成图片。
🎨 样式配置
基础选项
- 背景色: 默认纯白,支持自定义
- 文字色: 默认黑色,支持自定义
- 对齐方式: 支持居中、左对齐、右对齐
- 字体: 自适应中文字体,支持自定义字体族
- 尺寸: 默认 3:4 比例,可自定义宽高
高级功能
- 水印: 可添加自定义水印文字
- 阴影: 标题文字阴影效果
- 主题: 支持亮色/暗色主题
- 多格式: PNG、JPG、PDF 输出格式
📚 详细文档
- MCP 服务使用指南 - 完整的 MCP 服务配置和使用说明
- imgkit/wkhtmltopdf 使用指南 - 完整的安装和使用说明
- 实现总结 - 技术实现详细说明
🔧 故障排除
如果遇到渲染问题,系统会自动尝试以下后端顺序:
- imgkit/wkhtmltopdf (最佳质量)
- markdown-pdf-cli
- md-to-image (CLI/API)
- PIL 备选 (保证可用)
This server cannot be installed
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.