betterimage.io

betterimage.io MCP 服务

为 AI 助手提供社交卡片和 OG 图片。给 Claude、Cursor、VS Code 或任何 MCP 客户端一个页面 URL，即可获得一张采用适合该页面的设计制作的链接预览卡片；浏览 100 款入门设计，用自己的文字预览，查看链接在 X、LinkedIn、Slack 和 Discord 上的预览效果，生成 Open Graph 和 Twitter 标签；拥有账户后，还可以保存模板、渲染无水印图片，并获取无需托管的签名 og:image URL。

每张图片都由设计好的模板通过确定性渲染器生成：文字会变化，布局、字体和颜色则保持品牌风格。整个过程不涉及生成式图片模型。

此仓库包含托管服务的公开分发文件（安装清单、注册表元数据）。服务本身运行于 **https://betterimage.io/mcp**，文档见 https://betterimage.io/mcp。

端点

URL	身份验证	用途
https://betterimage.io/mcp	无（可选 API 密钥）	无需账户即可使用免费工具。传入 Authorization: Bearer <api key> 即可解锁账户工具。
https://betterimage.io/mcp/account	OAuth 2.1	同一服务；未通过身份验证的调用会返回 401，并在 claude.ai、Claude Desktop、Claude Code 和其他支持 OAuth 的客户端中启动登录流程。

传输方式：Streamable HTTP。协议修订版本：2024-11-05 至 2026-07-28。

安装

Claude Code

# free tools, no account
claude mcp add --transport http betterimage https://betterimage.io/mcp

# your own templates: sign in once (run /mcp in a session, pick betterimage, Authenticate)
claude mcp add --scope user --transport http betterimage https://betterimage.io/mcp/account

claude.ai / Claude Desktop：依次选择 Settings > Connectors > Add custom connector，URL 填写 https://betterimage.io/mcp/account。

Cursor：在 https://betterimage.io/mcp 上点击一键安装按钮，或添加到 mcp.json：

{
  "mcpServers": {
    "betterimage": { "url": "https://betterimage.io/mcp" }
  }
}

VS Code：在 https://betterimage.io/mcp 上点击一键安装按钮，或添加到 .vscode/mcp.json：

{
  "servers": {
    "betterimage": { "type": "http", "url": "https://betterimage.io/mcp" }
  }
}

Gemini CLI：运行 gemini extensions install https://github.com/mfundakowski/betterimage-mcp，或添加到 settings.json：

{
  "mcpServers": {
    "betterimage": { "httpUrl": "https://betterimage.io/mcp" }
  }
}

ChatGPT（Plus/Pro，Developer mode）：依次选择 Settings > Apps & Connectors > Create，URL 填写 https://betterimage.io/mcp，无需身份验证。

任何其他客户端：通过 Streamable HTTP 连接到 https://betterimage.io/mcp。

工具

无需账户：

• card_from_url：一次调用即可为现有页面生成社交卡片。像爬虫一样抓取页面，选择适合的设计，并返回图片（带水印的预览）。
• list_presets：列出 100 款入门设计，包括键、尺寸、类别和预览图片。
• preview_card：使用你的文字渲染预设（带水印的预览，不占用配额）。
• check_link_preview：查看 X、Facebook、LinkedIn、Slack 和 Discord 对某个 URL 的展示效果，并提供具体的修正建议。
• generate_meta_tags：生成包含 Open Graph 和 Twitter 标签的完整 <head> 区块。

拥有账户后（OAuth 或 API 密钥）：

• list_templates、save_template：管理已保存的设计。
• render_card：从已保存的模板生成无水印 PNG（付费套餐；免费套餐生成的图片带水印）。
• og_image_url：生成签名 og:image URL；首次抓取时渲染并缓存在边缘节点，因此每个页面都能拥有自己的卡片，无需托管。
• get_usage：查看套餐、水印状态和月度配额。

每个渲染工具的 fields 对象还支持通过 URL 传入卡片图片： image_url、image2_url、logo_url 和 background_url。图片由 服务端抓取，并绘制到设计预设的槽位中。这让一个已保存的模板能够变成 一整套目录：每个产品一张卡片，同时保持相同的颜色、字体和裁切构图。 支持不超过 5 MB 的 PNG、JPEG 或 WebP 图片；格式根据字节内容而非 URL 判断。抓取机制经过 SSRF 加固，并会拒绝指向 betterimage.io 的 URL。

每个工具都带有标题以及 readOnlyHint/destructiveHint 注释；两个写入工具为 save_template 和 render_card。

注册表

• 官方 MCP 注册表：io.betterimage/betterimage（此仓库中的 server.json）
• Smithery：@matfun93/betterimage

Cursor 插件

.cursor-plugin/plugin.json 和 mcp.json 使此仓库可作为 Cursor 插件安装；该插件只会注册托管服务。

使用 JavaScript

如果你需要在代码中而非通过助手使用， @betterimage/cards 可从 Node、Bun、Deno 或边缘运行时生成相同的签名图片 URL，且没有任何依赖。

链接

• 文档：https://betterimage.io/mcp
• 隐私：https://betterimage.io/privacy
• 条款：https://betterimage.io/terms
• 支持：[email protected]