Mcp

com.ogmakev0.1.2更新於 Oct 10, 2026

Generate og:image social cards and signed ogmake.com image URLs from your AI assistant.

已驗證STDIO僅桌面Developer ToolsMedia & Design

概覽

AI 產生的概覽

讓 AI 助理產生 og:image 社群卡片，以及 ogmake.com 的簽章圖片網址。

功能
這是一個用於 ogmake.com og:image 產生的本機 stdio 伺服器。工具包括：list_templates（列出範本 id、版本與參數 JSON Schema）、render_image（依範本產生社群卡片，或只憑標題產生帶浮水印的免費圖片）、render_html（把原始 HTML/CSS 算繪成 PNG/JPG/WebP/PDF）、create_batch 與 get_batch（最多 500 個算繪的非同步批次）、build_image_url（產生簽章或公開圖片網址）、og_snippet（產生各框架的 meta 標籤片段），以及 get_usage（查詢目前計費週期的用量配額）。
適用情境
適合需要助理為頁面產生社群分享圖片或 og:image meta 標籤，或需要批次算繪的情境，不必離開對話即可完成。如果你已在使用 ogmake.com，或想用範本批次產生卡片，值得安裝；沒有 API key 時只能使用範本清單、帶浮水印的免費算繪、網址建構與片段產生。
執行需求
透過 npx -y ogmake-mcp 在本機執行（需要 Node.js）。選用環境變數：OGMAKE_API_KEY 用於需驗證的 render_image、render_html、create_batch、get_batch 與 get_usage；OGMAKE_BASE_URL 覆寫 API 來源；OGMAKE_SIGNING_SECRET 與 OGMAKE_SIGNING_KEY_ID 用於本機簽章網址；OGMAKE_PUBLIC_KEY_ID 用於未簽章的公開網址。算繪需要連線至 ogmake.com 的網路存取。
安裝前請注意
需驗證的算繪會消耗額度（render_html 為 2 credits），create_batch 一次最多可發起 500 個算繪，因此會產生費用。密鑰 OGMAKE_API_KEY 與 OGMAKE_SIGNING_SECRET 從環境變數讀取；README 稱其僅保留在本機且不會被回傳。選用的 webhookUrl 會收到簽章的 batch.completed 事件。算繪內容與批次會傳送至 ogmake.com，託管網址也儲存在該處。

安裝

在 SourceWeft 中

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

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

ogmake-mcp

Local stdio MCP server for ogmake.com og:image generation. Run it with npx -y ogmake-mcp.

Tools

  • list_templates — lists every registered og:image template id, version, and its params JSON Schema. No API key required.
  • render_html — renders raw HTML/CSS to a stored PNG/JPG/WebP/PDF (2 credits; needs OGMAKE_API_KEY).
  • render_image — renders an og:image.
    • With OGMAKE_API_KEY set: renders template (+ optional params, format, preset, scale, v, bg, font — a Google Fonts family) via the authenticated API and returns its hosted URL plus the image bytes.
    • With no OGMAKE_API_KEY: renders a watermarked free image from title (+ optional description, site) and returns image bytes only — no hosted URL (the free endpoint never stores one).
  • create_batch — starts an async batch of up to 500 renders (POST /v1/batch); returns a batch_id immediately. Optional webhookUrl (https) gets a signed batch.completed event. Needs OGMAKE_API_KEY.
  • get_batch — a batch's status plus each item's stored URL or error. Needs OGMAKE_API_KEY.
  • build_image_url — builds an image URL for template without rendering it.
    • With OGMAKE_SIGNING_SECRET + OGMAKE_SIGNING_KEY_ID set: signs the URL locally (HMAC-SHA256) — the signing secret never leaves your machine and is never sent to the model.
    • Else with OGMAKE_PUBLIC_KEY_ID set: builds an unsigned /p/:keyId/:template URL (the key must be marked public and allow-list that template on ogmake.com).
  • og_snippet — renders the og:image/twitter:image meta tag snippet for a given framework (html, hugo, jekyll, rails, laravel, django, wordpress, ghost) and image URL.
  • get_usage — current billing period's render usage/quota for the OGMAKE_API_KEY account. Requires OGMAKE_API_KEY.

Every secret (OGMAKE_API_KEY, OGMAKE_SIGNING_SECRET) stays local: it is read from the environment once at startup and is never echoed back in a tool result, error message, or log line.

Environment variables

VariableRequired for
OGMAKE_API_KEYauthenticated render_image, render_html, create_batch, get_batch, get_usage
OGMAKE_BASE_URLoptional — override the API origin (defaults to https://ogmake.com)
OGMAKE_SIGNING_SECRETlocal signing in build_image_url (base64url)
OGMAKE_SIGNING_KEY_IDlocal signing in build_image_url (paired with the secret above)
OGMAKE_PUBLIC_KEY_IDunsigned /p URLs in build_image_url

Install

Claude Code

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

Or add to .mcp.json (project scope) / ~/.claude.json (user scope); Cursor takes the same block in ~/.cursor/mcp.json:

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

Without OGMAKE_API_KEY only list_templates, watermarked free render_image, build_image_url and og_snippet work.

Support: [email protected] · License: MIT

Development

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

Development

vendor/ holds the SDK and request-signing helper this server bundles, so the repository builds standalone: npm install && npm run build && npm test.

來源：README.md，提交 5e1e287

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.1.2最新Oct 10, 2026