previewglow

previewglow

previewglow は、リンクプレビューや Open Graph 画像を管理するホスト型の Shareglow MCP サーバーへの、小規模なローカルブリッジです。公開ページを指定すると、 ページのプレビューメタデータ、プラットフォームごとの プレビュー、検出された問題とその修正案を報告します。また、ワークスペースのテンプレートから 1200x630 の OG 画像をレンダリングしたり、サイト独自のブランドに合わせて新しい テンプレートをデザインしたり、プレビューが付いた短縮リンクを作成したり、 そのリンクのクリック状況を報告したり、タグが変更されたページをソーシャルプラットフォームに 再取得させたりできます。

このブリッジは、プレビューのデータを独自には保持しません。稼働中のエンドポイントから 取得した上流サーバーのツール一覧を、そのままローカルで提供し、各ツール呼び出しを上流に転送して、 結果を変更せずに返します。ここでのすべての操作は、呼び出し元自身の Shareglow ワークスペース、または呼び出し元が指定した公開ページを対象とします。このインターフェースには 送信、支払い、メッセージングのためのツールはありません。

ツール

• scan_url — 公開ページをスキャンし、リンクプレビュー（Open Graph / Twitter Card）の メタデータ、プラットフォームごとのプレビュー、問題と修正案を報告します。必須：url。
• generate_og_image — テンプレートから 1200x630 の Open Graph 画像をレンダリングします。必須：templateId。 任意：params（タイトルやサブタイトルなどのテキスト値）と exp（Unix 秒。署名付き URL の有効期限を設定します。有料プラン向け）。 永続的な画像 URL と、すでにキャッシュされていたかどうかを返します。
• create_template_from_url — AI を使って、ウェブサイトのブランド（ロゴ、 色、フォント）に合わせた新しい OG 画像テンプレートをデザインします。必須：url。 選択された layoutId、渡す変数、抽出されたブランドキットを返します。
• list_templates — ワークスペースでレンダリングできる OG 画像テンプレート（組み込みおよびカスタム）を、id、 name、version、dimensions とともに一覧表示します。引数は不要です。 テンプレートを選ぶため、generate_og_image の前に呼び出してください。
• create_short_link — 独自のリンクプレビューが付いた短縮リンクを作成します。必須：destination。任意： slug と最大 3 件の A/B variants。id、 shortUrl、variants を返します。
• get_link_stats — 短縮リンクのクリック分析を取得します。合計に加え、日、 国、デバイス、ブラウザー、リファラー別の内訳を返します。必須：linkId。 任意：from / to の日付（YYYY-MM-DD）。
• refresh_preview — OG タグまたは画像の変更後、ソーシャルプラットフォームにページのリンクプレビューを 再取得させます。必須：url。

設定

• SHAREGLOW_MCP_URL（任意）— 上流エンドポイントを上書きします。デフォルトは https://mcp.getshareglow.com/mcp です。（この上書き用フックは、この再構築独自のラベル付き再現です。）
• SHAREGLOW_API_KEY（任意）— 設定すると、すべての上流リクエストに、呼び出し元自身の Shareglow キー（呼び出し元の Shareglow ダッシュボードで作成した sk_live_... キー）用の Authorization: Bearer <key> ヘッダーが付加されます。未設定の場合、キーのヘッダーは送信されません。（ヘッダー名と Bearer の形式は、元のレジストリレコードで固定されています。この環境変数からキーを転送する機能はラベル付きの再現であり、元のインターフェースはキーなしで取得されました。）

転送の仕組み

最初のツール呼び出し時に、クライアントはアップストリームとのストリーミング可能な HTTP セッションを開きます。JSON-RPC initialize リクエスト（protocolVersion 2025-03-26、 clientInfo name previewglow）、続いて notifications/initialized 通知、さらに呼び出し元の引数を 変更せずに含む tools/call リクエストを送信します。アップストリームが Mcp-Session-Id ヘッダーを付けて initialize に応答すると、その値は セッションの以降のすべてのリクエストに引き継がれ、プロセスの終了まで 再利用されます。応答は通常の JSON またはサーバー送信イベントとして届く場合があり、どちらも読み取られます。

アップストリームの成功した結果は、アップストリームが設定した isError フラグも含め、 そのまま通過します。JSON-RPC エラー、2xx 以外のステータス、 読み取り不能な応答、または完了できないリクエストなどの失敗は、 テキストが previewglow error: で始まる isError 結果として返されます （この表示は、この再構築独自のラベル付き表現です）。

CLI

各ツールは、JSON 引数文字列を受け取るサブコマンドとしても実行できます。

npx @reneturcios/previewglow scan_url '{"url":"https://example.com/landing"}'
npx @reneturcios/previewglow get_link_stats '{"linkId":"lnk_abc-123"}'
npx @reneturcios/previewglow --version

終了コード：成功時は 0、isError 結果の場合は 1、使用方法のエラーの場合は 2 です。

MCP サーバー

npx -y @reneturcios/previewglow mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "previewglow": {
      "command": "npx",
      "args": ["-y", "@reneturcios/previewglow", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/previewglow
docker run --rm ghcr.io/cloudcorprecords/previewglow --version

コンテナーのデフォルトコマンドは mcp です。そのため、最初の形式は stdio MCP サーバーとして動作し、それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべて、スタブ化された JSON-RPC アップストリームを使用して実行されます。実際のネットワーク呼び出しはありません。

ライセンス

MIT — LICENSE を参照してください。