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
<div align="center">
media-gen-mcp
面向 Claude Code 的免费文生图 + 文生视频 MCP Server
文生图 / 图生图 / 文生视频 / 图生视频 / 关键帧动画 —— 全免费(借 Agnes AI + 智谱 免费模型)
English | 简体中文 | 日本語 | Español | Français | Deutsch | Русский | Português
</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 装包到缓存,项目内不可用)。
架构 + 文档
Provider 可插拔(agnes + zhipu,新增 provider 零改工具层)。更多见 doc/:
💝 支持作者
如果 media-gen-mcp 帮到你,欢迎请作者喝杯咖啡 ☕
<div align="center">
| 微信 | 支付宝 |
|---|---|
| <img src="doc/support-wechat.jpg" height="220" alt="微信"> | <img src="doc/support-alipay.jpg" height="220" alt="支付宝"> |
</div>
或 ⭐ Star、提 Issue / PR —— 都是对作者的支持。
License
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.