jimeng-mcp

即梦 AI 的 MCP 服务 — 让 Claude、Cursor 等 AI 助手直接调用即梦的图片/视频生成能力。

English | 中文

这是什么

MCP（Model Context Protocol） 是 Anthropic 推出的开放协议，允许 AI 模型通过标准化接口调用外部工具和服务。

jimeng-mcp 将字节跳动旗下即梦 AI 的官方 Volcengine API 封装为 MCP 服务。接入后，你可以在 Claude、Cursor 等支持 MCP 的客户端里，用自然语言直接驱动即梦生成图片和视频——无需打开浏览器，无需手动上传，生成结果自动保存到本地。

能做什么

图片能力

视频能力

使用场景

• 内容创作者：对话式生成配图和视频素材，不切换工具
• 产品/设计：在 Cursor 里边改需求文档边生成原型图
• 营销团队：批量生成不同风格的创意图，描述即出图
• 开发者：在自己的 AI 应用中集成即梦能力，无需关心鉴权细节

快速上手

第一步：开通服务

1. 登录火山引擎控制台，开通即梦 AI 服务
2. 在访问控制 → API 访问密钥获取 Access Key ID 和 Secret Access Key

第二步：安装

推荐使用 uvx（无需手动安装，运行时自动拉取）：

uvx jimeng-ai-mcp

也可以用 pip 全局安装：

pip install jimeng-ai-mcp

第三步：配置 MCP 客户端

Claude Desktop

配置文件路径：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jimeng": {
      "command": "uvx",
      "args": ["jimeng-ai-mcp"],
      "env": {
        "JIMENG_ACCESS_KEY_ID": "填入你的 Access Key ID",
        "JIMENG_SECRET_ACCESS_KEY": "填入你的 Secret Access Key"
      }
    }
  }
}

Cursor

配置文件路径：~/.cursor/mcp.json

{
  "mcpServers": {
    "jimeng": {
      "command": "uvx",
      "args": ["jimeng-ai-mcp"],
      "env": {
        "JIMENG_ACCESS_KEY_ID": "填入你的 Access Key ID",
        "JIMENG_SECRET_ACCESS_KEY": "填入你的 Secret Access Key"
      }
    }
  }
}

重启客户端后，在对话框里直接输入指令即可，例如："帮我生成一张赛博朋克风格的城市夜景图"

本地开发模式

git clone https://github.com/andyleimc-source/jimeng-ai-mcp

cd jimeng-mcp
cp .env.example .env
# 用编辑器打开 .env，填入两个密钥
uv sync
uv run jimeng-mcp

本地调试（启动 MCP Inspector）：

uv run mcp dev src/jimeng_mcp/server.py

使用示例

以下是在 Claude Desktop 中的实际对话示例：

文生图

帮我生成一张宋代山水画风格的图片，16:9 横幅，用即梦 4.0 模型

图生图

把这张产品图的背景换成简洁的白色摄影棚风格，保留产品主体不变 [附上图片 URL]

文生视频

生成一段 10 秒的视频：一只狐狸在雪地里奔跑，慢镜头，电影感，16:9

图生视频（首尾帧）

我有两张图，帮我生成首尾帧驱动的视频，开头是这张日出照片，结尾是这张夕阳照片，5 秒 首帧：[URL1]，尾帧：[URL2]

数字人

用这张人物图片和这段音频，生成一个口型同步的数字人视频，输出 1080P 图片：[URL]，音频：[URL]

视频翻译

把这个中文视频翻译成英文，口型同步 [视频 URL]

工具参数速查

generate_image

generate_video

image_to_video

translate_video

语言代码：zh 中文 · en 英语 · ja 日语 · ko 韩语 · fr 法语 · de 德语 · es 西班牙语 · pt 葡萄牙语 · ru 俄语 · ar 阿拉伯语 · it 意大利语

环境变量

相关资源

• 即梦 AI 开放平台 — 接口总览
• 即梦 AI 官网
• 火山引擎控制台
• MCP 协议规范
• Claude Desktop 下载
• 火山引擎签名机制文档

License

MIT