media-gen-mcp

面向 Claude Code 的免费文生图 + 文生视频 MCP Server

文生图 / 图生图 / 文生视频 / 图生视频 / 关键帧动画 —— 全免费(借 Agnes AI + 智谱 免费模型)

English | 简体中文 | 日本語 | Español | Français | Deutsch | Русский | Português

① 获取免费 Key

到下面任一家(或都)注册,拿一个免费 API Key:

详细图文步骤:doc/Agnes 开通指引 · doc/Zhipu 开通指引

Related MCP server: jimeng_visual_generation

② 配置(一次性)

新建 ~/.media-gen-mcp/config.json,填 Key:

{
  "providers": {
    "agnes": { "apiKey": "sk-你的agnes-key" },
    "zhipu": { "apiKey": "你的智谱-key" }
  }
}

只配 agnes 也行(删掉 zhipu 那行)。不填 models 用内置默认模型即可。

③ 接入 Claude Code

claude mcp add media-gen-mcp npx media-gen-mcp

接入命令不带 Key(Key 在上面的 config 里)。/mcp 看到 media-gen-mcp ✓ Connected 即成功。

④ 用

在 Claude Code 里直接说(自动路由到对应 provider/模型):

不指定就走默认;指定厂商/模型只影响本次调用,不改 config。

Providers

切换:defaultProvider: "zhipu",或按模态 defaultImageProvider/defaultVideoProvider,或单次工具传 provider。不知道选谁?见 横评。

📌 配置项(进阶,一般用不到)

默认 provider 三级回退(工具参数 > 按模态 > 全局):

例如 defaultProvider: "agnes" + defaultVideoProvider: "zhipu" → 图走 agnes、视频走智谱。不写后两个字段则全部回退到 defaultProvider。

各 provider 连接配置:

限流自适应(rateLimits / rateLimitTtlMs)等高级字段详见 doc/。

FAQ

视频慢? 3–18s,生成约 1–3 分钟。省略 wait 自动异步,完成通知。 帧数? 传 durationSeconds 自动选(5/10/18s)。Agnes 仅允许 81/121/161/241/441。 撞 429? 内置 62s 串行 + 自动学习真实限流。 没读到 config? 必须在 ~/.media-gen-mcp/config.json(npx 装包到缓存,项目内不可用)。

架构 + 文档

Provider 可插拔(agnes + zhipu,新增 provider 零改工具层)。更多见 doc/:

• doc/Agnes 开通指引 · doc/Zhipu 开通指引 · doc/Agnes vs 智谱 横评

💝 支持作者

如果 media-gen-mcp 帮到你,欢迎请作者喝杯咖啡 ☕

或 ⭐ Star、提 Issue / PR —— 都是对作者的支持。

License

MIT