MCP 服务器

media-gen-mcp

A free MCP server for generating images and videos from text or other images using Agnes AI and Zhipu free models.

README

media-gen-mcp

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

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

</div>

① 获取免费 Key

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

Provider	免费	申请
Agnes AI(默认)	文生图 + 文生视频全免费	https://platform.agnes-ai.com/ → 注册 → API Keys
智谱 BigModel(可选,4K / 中文)	cogview-3-flash 图 + cogvideox-flash 视频永久免费	https://bigmodel.cn/usercenter/proj-mgmt/apikeys → 实名 → 创建 Key

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

② 配置(一次性)

新建 ~/.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-server

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

④ 用

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

场景	怎么说	说明
默认	"生成一张橙猫写实图" / "生成 5 秒海边视频"	走配置的 defaultImageProvider / defaultVideoProvider
指定厂商	"用智谱画张图" / "用 agnes 生成视频"	临时切 provider,不改配置
指定模型	"用 cogview-4 画一张" / "用 agnes-video-v2.0 生成"	用某具体模型(更高质量等)
厂商 + 模型	"用智谱 cogvideox-3 生成 4K 视频"	精确指定(4K / 首尾帧)
图生图	"把这张图转水彩"	参考图 → 新图
图生视频	"把这张图变成视频"	单图 → 视频
关键帧	"这两张图做个过渡动画"	多图 → 平滑过渡

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

Providers

	默认	图像(免费)	视频(免费)	特点
agnes	✅	agnes-image-2.1-flash	agnes-video-v2.0	全免费、写实质感、原生音画
zhipu(可选)		cogview-3-flash	cogvideox-flash	4K/60fps、中文原生、国内合规

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

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

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

字段	默认	说明
`defaultProvider`	`agnes`	全局默认(最终回退,两个模态都没指定时用它)
`defaultImageProvider`	同 `defaultProvider`	图像模态默认(`generate_image` 走它)
`defaultVideoProvider`	同 `defaultProvider`	视频模态默认(`create_video` / `get_video` 走它)

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

各 provider 连接配置:

字段	默认	说明
`providers.<name>.apiKey`	—	必填,每个 provider 一个
`providers.<name>.models.image.default`	provider 内置	默认图像模型
`providers.<name>.models.video.default`	provider 内置	默认视频模型
`outDir`	会话目录/output	输出目录(可被工具参数覆盖)

限流自适应(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 装包到缓存,项目内不可用)。