mcpField
O
ogmake

ogmake

本地服务
ogmake.com媒体与设计03 周前更新
代码仓库访问官网

关于 ogmake

ogmake 是通过 ogmake.com 生成 og:image 卡片的本地 stdio MCP 服务。它支持模板渲染、HTML/CSS 渲染、批量任务、URL 签名和元数据片段，部分功能无需 API 密钥即可使用。

主要功能

  1. 01列出图片模板及模式
  2. 02从模板或 HTML/CSS 渲染图片
  3. 03创建并查询渲染批次
  4. 04构建并在本地签名图片 URL
  5. 05生成特定框架的元数据片段
  6. 06查询账户用量和额度

适用场景

  1. 01为网站创建社交预览图
  2. 02批量渲染图片卡片
  3. 03生成签名图片 URL，且不发送签名密钥
  4. 04添加 Open Graph 和 Twitter 图片标签

MCP 相关

通过本地 stdio 将 ogmake.com 的图片生成和 URL 构建操作作为 MCP 工具提供。认证渲染与批量操作需 API 密钥；URL 可在本地签名。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "com-ogmake": {
      "command": "npx",
      "args": [
        "-y",
        "ogmake-mcp"
      ],
      "env": {
        "OGMAKE_API_KEY": "<OGMAKE_API_KEY>"
      }
    }
  }
}
启动命令npx -y ogmake-mcp
需要配置的环境变量
OGMAKE_API_KEY密钥ogmake.com API key. Optional: without it render_image uses the free watermarked endpoint.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmogmake-mcp0.1.2

工具

8

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

ogmake-mcp

用于 ogmake.com og:image 生成的本地 stdio MCP 服务。使用 npx -y ogmake-mcp 运行。

工具

  • list_templates — 列出所有已注册的 og:image 模板 ID、版本及其 params 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 meta 标签代码片段。
  • 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。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。