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