HTML Email Playbook

email-playbook-mcp

**阻止 AI 模型生成无法正常显示的 HTML 邮件。**这个 MCP 服务 + CLI 会为它们提供在 Outlook 2007+、Gmail 和 Apple Mail 中实际有效的模式，内容摘自 HTML Email Playbook。

没有它，模型会凭空编造 flex 和 grid（没有邮件客户端支持这些布局），硬编码在移动设备上会溢出的表格宽度，忘记为 Outlook 按钮提供 VML 回退方案，还会捏造设计中并不存在的页脚免责声明。

有了它，模型就能调用结构化工具，从 playbook 中提取准确的模式，并据此编写邮件，而不是根据训练数据猜测。

🔒 **不需要邮件权限，也无法访问收件箱。**这是一个知识型 MCP——它返回 playbook 规则和 HTML 模式。它绝不会读取或发送邮件，也不会索要 Gmail/Outlook/SMTP 凭据。它容易与集成收件箱的 MCP 混淆，但完全属于不同类别。

安装

# Global install (standard)
npm install -g email-playbook-mcp

# Or run on demand without installing
npx -y email-playbook-mcp@latest

安装安全可靠

• 只有一个依赖项——官方 MCP SDK（@modelcontextprotocol/sdk），没有其他依赖。
• 没有 postinstall 脚本——安装时不会运行任意代码。
• 只读，不接触收件箱——这些工具只返回 playbook 内容。它绝不会读取、发送或触碰邮件，也不会打开你的收件箱，更不会自行发起网络请求。

在 Claude Desktop 中使用

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "email-playbook": {
      "command": "email-playbook-mcp"
    }
  }
}

重启 Claude Desktop。playbook 工具会出现在模型的工具列表中。让它编写一封邮件，它就会自动调用这些工具。

实际运行方式

对于图片转邮件或“帮我制作一封欢迎邮件”这类提示词，模型通常会调用：

1. list_categories                                    ← orient, page slugs
2. get_playbook_rules({ format: "checklist" })        ← every page's rules, ~16 KB
3. get_rule({ slug: "compatibility/responsive" })     ← just the pages it needs
4. list_components → get_component({ name: "buttons" }) ← components it needs
5. compose final HTML using those exact patterns

你不需要手动编写该提示词——模型会通过工具说明来了解如何使用这些工具。

在 Cursor 中使用

编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "email-playbook": {
      "command": "email-playbook-mcp"
    }
  }
}

Cline / Continue / Windsurf 等支持 MCP 的客户端也使用相同的配置格式——将 command 条目指向 email-playbook-mcp。

作为 CLI 使用

同一个软件包还提供了第二个二进制文件，可用于直接查询和编写脚本：

$ email-playbook get-component buttons | jq '{name, slots, requires_vml}'
{
  "name": "buttons",
  "slots": ["text", "url", "background_color", "text_color", "width_px", "height_px"],
  "requires_vml": true
}

其他命令：list-categories、list-components、get-rules [category] [--checklist]、get-rule <slug> [--examples]；在 get-rules / get-rule 后添加 --md，即可输出便于阅读的 Markdown，而不是 JSON。MCP 工具名称也可直接作为命令名称使用（get_playbook_rules、get_rule 等）。帮助文本会在运行时根据随包附带的规范生成，不会过时。运行 email-playbook --help。

无需全局安装即可运行：

npx -y -p email-playbook-mcp email-playbook list-categories

工具

工具	返回内容
list_categories	4 个规则类别，包含页面数量和页面 slug
get_playbook_rules({ category?, format? })	规则页面：full（文本 + 代码，默认值，一次一个类别）或 checklist（需要遵循的规则；省略 category 可获取所有页面，约 16 KB）
get_rule({ slug, include_examples? })	单个规则页面及其代码（compatibility/responsive 或 responsive）；include_examples: true 会将代码作为单独的数组添加
list_components	全部 6 个组件及其元数据
get_component({ name })	单个组件：HTML 模式、插槽、VML/响应式标记

组件属于单独的维度——请使用 list_components / get_component，而不是 get_playbook_rules。

手册内容

界面	数量	涵盖内容
structure（规则）	5	Doctype、head、body 容器、页眉、正文、页脚
compatibility（规则）	3	Outlook MSO、RTL 语言、响应式
production（规则）	4	Gmail 102KB 截断、深色模式、预标题、可靠按钮
ai-generation（规则）	7	绝对规则、资源策略、内容保真度、图像占位符、链接令牌、输出格式、交接清单
组件	6	按钮、间距、图像、内联图标、背景图像、文本

对于图像转邮件任务，应首先获取 ai-generation 类别。它包含覆盖训练数据直觉的规则——使用 {{cta_url}}，而不是 https://example.com；只复现源材料中的内容；对于没有提供真实 URL 的每张图像，都使用 placehold.co PNG 区块；仅返回 HTML。

它不做什么

• 不发送邮件——在此处生成 HTML，然后通过现有平台发送。
• 不渲染预览——Playground 可以做到（如果你有截图，其中还有一个“从图像生成”选项卡）。
• 不验证现有 HTML——通过交接清单手动检查。

托管版替代方案

不想安装？将任意 JSON-RPC 2.0 客户端指向 https://docs.osamahassouna.com/api/mcp。工具和内容相同，无需身份验证。

curl -X POST https://docs.osamahassouna.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

许可证

MIT © Osama Hassouna

• HTML 邮件手册
• 安装与配置文档
• 源代码（mcp/ 目录）