betterimage.io

io.betterimage由 betterimage.io 發布官方發布者v1.2.0更新於 Oct 25, 2026

Social cards and OG images from designed templates: card from a URL, presets, meta tags, link checks

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取媒體與設計

概覽

AI 產生的概覽

託管型 MCP 伺服器,用設計範本產生社群卡片與 OG 圖片,檢查連結預覽效果並產生 meta 標籤。

可以做什麼
依既有頁面網址產生社群卡片,並自動挑選合適的設計;或瀏覽預設範本並用自訂文字預覽(帶浮水印,無需帳號)。檢查連結在 X、Facebook、LinkedIn、Slack 與 Discord 上的預覽效果,並產生 Open Graph 與 Twitter 的 head 標籤。使用帳號後可列出與儲存範本、從已儲存範本算圖為無浮水印 PNG,並產生首次抓取時才算圖的簽章 og:image 網址。查看方案、浮水印狀態與每月圖片配額。
適用情境
適合需要為頁面製作連結預覽圖或社群分享圖、排查連結預覽異常、或產生 Open Graph 與 Twitter 標籤的情境。也適合用一個已儲存範本為多個頁面或產品批次產出風格一致的卡片。
執行需求
遠端 Streamable HTTP 端點,無需本機安裝。免費工具無需帳號。帳號工具需要 API key(透過 Authorization Bearer 標頭傳送)或透過帳號端點進行 OAuth 2.1 登入。需要能連線至該託管服務的網路。
安裝前請注意
帳號工具需要憑證:API key 或 OAuth 登入。算圖會消耗每月圖片配額;免費方案圖片帶浮水印,無浮水印圖片需付費方案。save_template 與 render_card 會寫入你的帳號。傳入的頁面網址與圖片網址會由伺服器端抓取。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 betterimage.io,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.betterimage%2Fbetterimage/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

README

betterimage.io MCP server

Social cards and OG images for your AI assistant. Give Claude, Cursor, VS Code or any MCP client a page URL and get back a link-preview card on a design picked to fit the page; browse 100 starter designs, preview them with your own text, check how a link previews on X, LinkedIn, Slack and Discord, generate Open Graph and Twitter tags, and with an account save templates, render clean images and get signed og:image URLs that need no hosting.

Every image is rendered from a designed template by a deterministic renderer: the text changes, layout, fonts and colours stay on-brand. No generative image model is involved.

This repository holds the public distribution files for the hosted server (install manifests, registry metadata). The server itself runs at https://betterimage.io/mcp and is documented at https://betterimage.io/mcp.

Endpoints

URLAuthUse
https://betterimage.io/mcpnone (optional API key)Free tools work with no account. Pass Authorization: Bearer <api key> to unlock the account tools.
https://betterimage.io/mcp/accountOAuth 2.1Same server; an unauthenticated call answers 401 and starts the sign-in flow in claude.ai, Claude Desktop, Claude Code and other OAuth-capable clients.

Transport: Streamable HTTP. Protocol revisions 2024-11-05 through 2026-07-28.

Install

Claude Code

bash
# free tools, no accountclaude 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: one-click install button on https://betterimage.io/mcp, or add to mcp.json:

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

VS Code: one-click install button on https://betterimage.io/mcp, or add to .vscode/mcp.json:

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

Gemini CLI: gemini extensions install https://github.com/mfundakowski/betterimage-mcp, or add to settings.json:

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

ChatGPT (Plus/Pro, Developer mode): Settings > Apps & Connectors > Create, URL https://betterimage.io/mcp, no authentication.

Any other client: point it at https://betterimage.io/mcp over Streamable HTTP.

Tools

No account needed:

  • card_from_url: a social card for an existing page, in one call. Fetches the page like a crawler, picks the design that fits it, returns the image (watermarked preview).
  • list_presets: the 100 starter designs with key, size, categories and preview image.
  • preview_card: render a preset with your text (watermarked preview, no quota).
  • check_link_preview: what X, Facebook, LinkedIn, Slack and Discord will show for a URL, with concrete fixes.
  • generate_meta_tags: the complete <head> block with Open Graph and Twitter tags.

With an account (OAuth or API key):

  • list_templates, save_template: your saved designs.
  • render_card: a clean PNG from a saved template (paid plans; watermarked on the free tier).
  • og_image_url: a signed og:image URL rendered on first fetch and cached at the edge, so every page gets its own card with no hosting.
  • get_usage: plan, watermark status and monthly quota.

Every render tool's fields object also takes the card's pictures by URL - image_url, image2_url, logo_url and background_url - fetched server-side and drawn in the slot the design already lays out. That is what turns one saved template into a whole catalogue: one card per product, same colours, fonts and crop framing. PNG, JPEG or WebP up to 5 MB, decided by the bytes rather than the URL; the fetch is SSRF-hardened and a URL pointing back at betterimage.io is refused.

Every tool carries a title and readOnlyHint/destructiveHint annotations; the two write tools are save_template and render_card.

Registries

  • Official MCP Registry: io.betterimage/betterimage (server.json in this repo)
  • Smithery: @matfun93/betterimage

Cursor plugin

.cursor-plugin/plugin.json and mcp.json make this repository installable as a Cursor plugin; the plugin only registers the hosted server.

In JavaScript

For code rather than an assistant, @betterimage/cards builds the same signed image URLs from Node, Bun, Deno or an edge runtime, with no dependencies.

Links

來源:README.md,提交 2631b76

工具

10

card_from_url

Card from a page URL

Make a social card for a page that already exists, in one call: fetches the page like a crawler, takes its title, description, author, domain and site icon, picks the starter design that fits the page (a Jev decision over every preset, about 100 ms) and returns the image (shown inline, watermarked, free). Use this first when the user gives a URL: "make an OG image for my latest post". Any field you pass overrides what the page says. Pass preset (see list_presets) to choose the design yourself, or a size. No API key needed; one page fetch plus one render per call.

輸入參數url必填sizefieldspreset

list_presets

List starter designs

Browse the ready-made designs (presets) a card can start from: key, name, template kind, native size, use-case categories, a one-line look description and a preview image URL. Start here when the user wants a social card and has no saved template. Then call preview_card with the chosen key. No API key needed.

輸入參數kindquerycategory

preview_card

Preview a card from a preset

Render a preset with the user's text and return the image (shown inline). Free, no API key; the preview carries a small betterimage.io watermark and does not touch any quota. Use it to show the user what their card will look like before they commit. For a clean image: save_template + render_card on a paid API plan, or the one-off clean download in the editor.

輸入參數sizefieldspreset必填

generate_meta_tags

Generate meta tags

Build the complete <head> block for a page: <title>, meta description, canonical, Open Graph and Twitter card tags, with og:image width/height. Returns HTML to paste plus notes on anything worth fixing (title too long, image over http). Use after check_link_preview, or whenever a user needs the tags for a new page. No API key needed; nothing is fetched.

輸入參數urltypetitle必填image_altimage_urlsite_namedescriptionimage_widthimage_heighttwitter_card

list_templates

List saved templates

The user's saved templates (their own designs, made in the editor or with save_template): slug, name, kind, the fields render_card and og_image_url can override, and when it was last edited. Needs an API key. Call this before render_card or og_image_url when you do not know the slug.

無需輸入參數。

save_template

Save a preset as a template

Copy a preset (optionally with the user's text as its new defaults) into the user's account as a saved template, so render_card and og_image_url can use it. Needs an API key. Do this once per design, not per image: afterwards every render only passes the text that changes. Returns the slug to use next and a link to fine-tune the design in the editor.

輸入參數namesizefieldspreset必填

render_card

Render a saved template

Render one of the user's saved templates with the given text and return the PNG (shown inline, at 1x). Needs an API key. On a paid plan the image is clean (no watermark); on the free tier it is watermarked. Each call spends one image of the monthly quota. Use it when the user wants the actual file, e.g. to host it themselves. For an og:image tag that needs no hosting, or for a 2x retina file, prefer og_image_url.

輸入參數sizefieldstemplate必填

og_image_url

Signed og:image URL

Build a signed image URL for a saved template with the given text, ready to put in a page's <meta property="og:image"> tag. Nothing is rendered now: the image is generated when a crawler fetches the URL, cached at the edge for a day, and each uncached fetch spends one image of the monthly quota. Needs an API key. This is the zero-infrastructure way to give every page its own card; use it in page templates, CMS hooks and static site generators. Returns the URL and the ready meta tag.

輸入參數sizescalefieldstemplate必填

get_usage

Quota and plan

The API key's plan, whether renders are watermarked, and this month's image quota: used, remaining, and the reset date. Needs an API key. Check it before batch renders, or when a render came back watermarked unexpectedly.

無需輸入參數。

版本歷史

4
  1. v1.2.0最新Sep 25, 2026
  2. v1.1.0Sep 24, 2026
  3. v1.0.1Sep 22, 2026
  4. v1.0.0Sep 21, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分