genrelay-mcp

genrelay-mcp

适用于 GenRelay 的 MCP 服务 — 可通过 Claude Desktop、Cursor 或任意 MCP 客户端生成视频和图像。

一个服务，多个模型：Veo 3.1、Grok Imagine、Omni Flash、Nano Banana Pro/2、GPT Image 2。

安装

无需安装 — 使用 npx 将 MCP 客户端指向它即可。

Claude Desktop — claude_desktop_config.json：

{
  "mcpServers": {
    "genrelay": {
      "command": "npx",
      "args": ["-y", "genrelay-mcp"],
      "env": { "GENRELAY_API_KEY": "sk-..." }
    }
  }
}

Cursor — .cursor/mcp.json：

{
  "mcpServers": {
    "genrelay": {
      "command": "npx",
      "args": ["-y", "genrelay-mcp"],
      "env": { "GENRELAY_API_KEY": "sk-..." }
    }
  }
}

在 genrelay.ai 获取密钥。编辑配置后重启客户端。

工具

工具	功能
generate_video	文本生成视频和图像生成视频。返回视频片段；如果仍在处理中，则返回任务 ID
generate_image	图像生成和编辑。以内联形式返回图像
check_job	根据任务 ID 查询任务
list_models	查看可用模型及其用途

然后只需提出请求：

生成一段 8 秒的视频：一只霓虹狐狸在夜晚穿过下雨的城市，分辨率为 1080p

关于等待时间

视频生成需要 1–5 分钟 — 超出 MCP 工具调用允许的运行时间。因此，generate_video 会尽可能安全地等待，然后返回任务 ID：

Still generating — this is normal for video.

task id: task_abc123
status: in_progress
progress: 35%

Call check_job with task id "task_abc123" in a minute or two.

这是正常情况，并非失败。任务会继续在服务端运行 — 使用 check_job，不要重新提交（重新提交会再次收费）。

图像通常能在时间限制内完成，并以内联形式返回。

模型

视频

模型	说明
veo_3_1	Google Veo 3.1 — 质量最高，支持音频
veo_3_1-fl	首帧/尾帧 — 需提供两个端点
veo_3_1-components	组件引导
grok-imagine-video-1-5-preview	xAI Grok Imagine 1.5
grok-imagine-1-0-video	xAI Grok Imagine 1.0
omni-flash	速度快，适合生成较长片段
omni_flash_abra_edit	根据源视频编辑视频

图像 — nano-banana-pro、nano-banana-2、gpt-image-2

档位：图像为 1k/2k/4k，Veo 视频为 720p/1080p/4k。价格按档位计算；如果 size 不匹配任何档位，则按模型基础价格计费 — 因此，费用很重要时请明确设置 tier。

配置

变量
GENRELAY_API_KEY	必填
GENRELAY_BASE_URL	可选，默认为 https://genrelay.ai/v1

另有以下选项

• Python SDK — pip install genrelay
• JavaScript/TypeScript SDK — npm install genrelay
• 聊天和图像编辑与 OpenAI 兼容：将官方 openai 包指向 https://genrelay.ai/v1

开发

npm install
npm run build
node test/smoke.mjs   # boots the server and speaks MCP to it

常见问题

什么是 genrelay-mcp？ 这是一个 MCP 服务，可让 Claude Desktop、Cursor 和其他 MCP 客户端通过 GenRelay API 生成视频和图像。

支持哪些客户端？ 任何可以通过 npx -y genrelay-mcp 启动 stdio 服务的 MCP 客户端，包括 Claude Desktop 和 Cursor。

如何获取 API 密钥？ 在 genrelay.ai 注册，并在控制台中创建密钥。将其设为 GENRELAY_API_KEY。

如何计费？ 使用美元预付额度，按用量付费。请参阅定价。

视频仍在生成中。我需要重新提交吗？ 不需要。使用任务 ID 调用 check_job。重新提交会再次收费。

在哪里可以找到它？ 可在 npm 和官方 MCP Registry 中找到，名称为 io.github.gaoruitech/genrelay-mcp。

许可证

MIT