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：既存のページのソーシャルカードを 1 回の呼び出しで作成します。クローラーのようにページを取得し、適したデザインを選んで、画像を返します（透かし入りプレビュー）。
• 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 を指定すると、サーバー側で取得され、デザインにあらかじめ用意されたスロットに描画されます。これにより、保存したテンプレート 1 つから、色、フォント、トリミングの構図を統一した商品ごとのカードを作成し、カタログ全体に展開できます。PNG、JPEG、WebP に対応し、サイズは最大 5 MB です。判定は URL ではなくバイト数に基づきます。取得処理には SSRF 対策が施されており、betterimage.io を指す URL は拒否されます。

すべてのツールにはタイトルと readOnlyHint／destructiveHint アノテーションが付いています。書き込みツールは save_template と render_card の 2 つです。

レジストリ

• 公式 MCP Registry：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]