ogmake

ogmake-mcp

ogmake.com の og:image を生成する、ローカルの stdio MCP サーバーです。npx -y ogmake-mcp で実行できます。

ツール

• list_templates — 登録されているすべての og:image テンプレートの ID、バージョン、パラメーターの JSON Schema を一覧表示します。API キーは不要です。
• render_html — 生の HTML/CSS を、保存済みの PNG/JPG/WebP/PDF にレンダリングします（2 クレジット。OGMAKE_API_KEY が必要です）。
• render_image — og:image をレンダリングします。
  • OGMAKE_API_KEY が設定されている場合：認証済み API を通じて template（および任意の params、format、preset、scale、v、bg、font — Google Fonts のファミリー名）をレンダリングし、ホストされた URL と画像バイトを返します。
  • OGMAKE_API_KEY が設定されていない場合：title（および任意の description、site）からウォーターマーク付きの無料画像をレンダリングし、画像バイトのみを返します（無料エンドポイントでは保存されないため、ホストされた URL はありません）。
• create_batch — 最大 500 件のレンダリングを非同期バッチとして開始します（POST /v1/batch）。すぐに batch_id を返します。任意の webhookUrl（https）を指定すると、署名付きの batch.completed イベントを受け取れます。OGMAKE_API_KEY が必要です。
• get_batch — バッチのステータスと、各項目の保存済み URL またはエラーを返します。OGMAKE_API_KEY が必要です。
• build_image_url — template の画像 URL を、レンダリングせずに組み立てます。
  • OGMAKE_SIGNING_SECRET と OGMAKE_SIGNING_KEY_ID が設定されている場合：URL をローカルで署名します（HMAC-SHA256）。署名シークレットがマシンの外に出ることはなく、モデルに送信されることもありません。
  • それ以外の場合に OGMAKE_PUBLIC_KEY_ID が設定されている場合：署名なしの /p/:keyId/:template URL を組み立てます（キーは ogmake.com で公開として設定され、該当テンプレートが許可リストに登録されている必要があります）。
• og_snippet — 指定されたフレームワーク（html、hugo、jekyll、rails、laravel、django、wordpress、ghost）と画像 URL に対応する、og:image／twitter:image のメタタグスニペットを生成します。
• get_usage — OGMAKE_API_KEY アカウントの現在の請求期間におけるレンダリング使用量と上限を返します。OGMAKE_API_KEY が必要です。

すべてのシークレット（OGMAKE_API_KEY、OGMAKE_SIGNING_SECRET）はローカルに保持されます。起動時に環境変数から一度読み込まれ、ツールの結果、エラーメッセージ、ログ行に出力されることはありません。

環境変数

変数	必要な機能
OGMAKE_API_KEY	認証付きの render_image、render_html、create_batch、get_batch、get_usage
OGMAKE_BASE_URL	任意 — API のオリジンを上書きします（デフォルトは https://ogmake.com）
OGMAKE_SIGNING_SECRET	build_image_url でのローカル署名（base64url）
OGMAKE_SIGNING_KEY_ID	build_image_url でのローカル署名（上記シークレットと組み合わせて使用）
OGMAKE_PUBLIC_KEY_ID	build_image_url での署名なし /p URL

インストール

Claude Code

claude mcp add ogmake --env OGMAKE_API_KEY=og_live_... -- npx -y ogmake-mcp

または、.mcp.json（プロジェクトスコープ）／~/.claude.json（ユーザースコープ）に追加します。Cursor では同じブロックを ~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "ogmake": {
      "command": "npx",
      "args": ["-y", "ogmake-mcp"],
      "env": { "OGMAKE_API_KEY": "og_live_..." }
    }
  }
}

OGMAKE_API_KEY がない場合に使用できるのは、list_templates、ウォーターマーク付きの無料 render_image、build_image_url、og_snippet のみです。

サポート：[email protected] · ライセンス：MIT

開発

pnpm --filter ogmake-mcp run test        # unit tests, 100% coverage
pnpm --filter ogmake-mcp run test:e2e    # spawns the packed CLI over stdio against a local wrangler dev
pnpm --filter ogmake-mcp run build       # tsup bundle -> dist/index.js
pnpm --filter ogmake-mcp run pack        # build + npm pack -> pack-out/*.tgz

開発

vendor/ には、このサーバーにバンドルされている SDK とリクエスト署名ヘルパーが格納されているため、リポジトリ単体でビルドできます：npm install && npm run build && npm test。