Skip to main content
Glama

jimeng-mcp

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

English | 中文


这是什么

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

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

Related MCP server: Jimeng AI Multimodal MCP

能做什么

图片能力

工具

能力

底层模型

generate_image

文生图,支持 4.0 / 4.6 / 3.x 多模型

即梦图片系列

image_to_image

图生图,智能参考原图风格/内容进行编辑

jimeng_i2i 3.0

inpaint_image

局部重绘:涂抹修改或消除画面元素

inpaint

upscale_image

智能超清:低清图片放大到 4K / 8K

Seedream SR

视频能力

工具

能力

底层模型

generate_video

文生视频,720P / 1080P / Pro 三档

即梦视频 3.0

image_to_video

图生视频:首帧、首尾帧、重新运镜、Pro 模式

即梦视频 3.0

imitate_motion

动作模仿:将参考视频的动作迁移到目标人物

DreamActor 2.0

generate_digital_human

数字人:图片 + 音频 → 口型同步说话视频

OmniHuman 1.5

translate_video

视频翻译:保留音色,口型同步换语言

翻译 2.0

使用场景

  • 内容创作者:对话式生成配图和视频素材,不切换工具

  • 产品/设计:在 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

参数

类型

默认值

说明

prompt

string

必填

图片描述

model

string

jimeng_t2i_v40

jimeng_t2i_v40 / jimeng_seedream46_cvtob / jimeng_t2i_v31 / jimeng_t2i_v30

aspect_ratio

string

1:1

1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3

quality

string

2k

2k 或 normal

negative_prompt

string

""

不希望出现的内容

generate_video

参数

类型

默认值

说明

prompt

string

必填

视频描述

model

string

jimeng_t2v_v30

jimeng_t2v_v30(720P)/ jimeng_t2v_v30_1080p(1080P)/ jimeng_ti2v_v30_pro(Pro)

aspect_ratio

string

16:9

16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9

duration_sec

int

5

5 或 10 秒

image_to_video

参数

类型

默认值

说明

image_url

string

必填

首帧图片 URL

prompt

string

必填

视频描述

mode

string

first

first / first_1080p / first_tail / first_tail_1080p / recamera / pro

duration_sec

int

5

5 或 10 秒

tail_image_url

string

""

尾帧图片(first_tail / first_tail_1080p 模式必填)

translate_video

参数

类型

默认值

说明

video_url

string

必填

原视频 URL

target_language

string

必填

目标语言代码

src_language

string

zh

源语言代码

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

环境变量

变量

必填

说明

JIMENG_ACCESS_KEY_ID

✅

火山引擎 Access Key ID

JIMENG_SECRET_ACCESS_KEY

✅

火山引擎 Secret Access Key

JIMENG_OUTPUT_DIR

可选

生成文件保存目录,默认 ~/jimeng-output

相关资源

License

MIT

Available Tools

9 tools
generate_digital_humanA

数字人生成(OmniHuman 1.5):驱动人物图片口型和动作,配合音频生成说话视频。 使用模型:jimeng_realman_avatar_picture_omni_v15

  • portrait_url: 人物肖像图片 URL(含人物/动漫/宠物)

  • audio_url: 驱动音频 URL(WAV/MP3,必须小于 60 秒)

  • resolution: 输出分辨率,720 或 1080(默认 1080)

  • prompt: 可选提示词,支持中/英/日/韩语,最长 300 字符

注意:此接口使用 CVSubmitTask/CVGetResult(与普通接口不同)。

Inputs: audio_url (required), portrait_url (required), prompt, resolution. Returns: result

generate_imageA

文生图:根据文字描述生成图片。

  • model(模型版本):

    • jimeng_t2i_v40 图片生成 4.0(默认,推荐)

    • jimeng_seedream46_cvtob 图片生成 4.6(Seedream,支持最高 4K)

    • jimeng_t2i_v31 文生图 3.1

    • jimeng_t2i_v30 文生图 3.0

    • jimeng_high_aes_general_v21_L 通用高美感 v2.1

  • aspect_ratio: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3

  • quality: 2k(默认)/ normal

  • negative_prompt: 负面提示词(可选,部分模型不支持)

Inputs: prompt (required), model, quality, aspect_ratio, +1 more. Returns: result

generate_videoA

文生视频:根据文字描述生成视频(约需 1~5 分钟)。

  • model(模型版本):

    • jimeng_t2v_v30 视频生成 3.0 720P(默认)

    • jimeng_t2v_v30_1080p 视频生成 3.0 1080P

    • jimeng_ti2v_v30_pro 视频生成 3.0 Pro 1080P(效果更好)

  • aspect_ratio: 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9

  • duration_sec: 5(默认)或 10

Inputs: prompt (required), model, aspect_ratio, duration_sec. Returns: result

image_to_imageA

图生图(智能参考):参考输入图片,结合文字描述编辑或生成新图片。 使用即梦图生图 3.0 模型(jimeng_i2i_v30)。

  • image_url: 参考图片 URL(JPEG/PNG,最大 4.7MB,最大 4096×4096)

  • aspect_ratio: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3

  • quality: 2k(默认)/ normal

  • scale: 文本影响程度 0.0~1.0(默认 0.5,越大越贴近文字描述,越小越保留原图)

Inputs: prompt (required), image_url (required), scale, quality, +1 more. Returns: result

image_to_videoA

图生视频:将静态图片转换为动态视频(约需 1~5 分钟)。

  • image_url: 首帧图片 URL(JPEG/PNG,最大 4.7MB)

  • prompt: 视频内容描述(必填)

  • mode(模式):

    • first 首帧驱动 720P(默认)

    • first_1080p 首帧驱动 1080P

    • first_tail 首尾帧驱动 720P(需提供 tail_image_url)

    • first_tail_1080p 首尾帧驱动 1080P(需提供 tail_image_url)

    • recamera 重新运镜 720P(需提供 template_id,通过 prompt 描述运镜效果)

    • pro 视频生成 3.0 Pro 1080P(首帧,效果更好)

  • duration_sec: 5(默认)或 10

  • tail_image_url: 尾帧图片 URL(仅 first_tail / first_tail_1080p 模式需要)

recamera 模式可用运镜模板(在 prompt 中指定 template_id): hitchcock_dolly_in / hitchcock_dolly_out / robo_arm / dynamic_orbit / central_orbit / crane_push / quick_pull_back / counterclockwise_swivel / clockwise_swivel / handheld / rapid_push_pull

Inputs: prompt (required), image_url (required), mode, duration_sec, +1 more. Returns: result

imitate_motionA

动作模仿 2.0:提取参考视频中的动作/表情/口型,迁移到目标人物图片上。 使用模型:jimeng_dreamactor_m20_gen_video

  • image_url: 目标人物图片 URL(JPEG/PNG,480×480 以上,1920×1080 以内)

  • video_url: 动作参考视频 URL(MP4/MOV/WEBM,最长 30 秒)

输出视频约需 3~5 分钟(10 秒视频约需 180 秒)。

Inputs: image_url (required), video_url (required). Returns: result

inpaint_imageA

局部重绘(Inpainting):在图片的指定区域(mask)内根据提示词重新生成内容。 使用即梦交互编辑模型(jimeng_image2image_dream_inpaint)。

  • image_url: 原图 URL(JPEG/PNG,最大 4.7MB)

  • mask_url: 遮罩图 URL(单通道灰度图,白色=重绘区域,黑色=保留区域)

  • prompt: 重绘内容描述;输入"删除"可消除选区内容

Inputs: prompt (required), mask_url (required), image_url (required). Returns: result

translate_videoA

视频翻译 2.0:将视频中的语音翻译并口型同步为目标语言。 使用模型:video_translate_v2_cvtob

  • video_url: 原始视频 URL(需公网可访问)

  • target_language: 目标语言缩写

  • src_language: 源语言缩写(默认 "zh" 中文)

支持的语言代码: zh(中文)en(英语)ja(日语)ko(韩语)fr(法语)de(德语) es(西班牙语)pt(葡萄牙语)ru(俄语)ar(阿拉伯语)it(意大利语) hi(印地语)id(印尼语)nl(荷兰语)tr(土耳其语)pl(波兰语)等

Inputs: video_url (required), target_language (required), src_language. Returns: result

upscale_imageA

智能超清:将图片放大并增强细节至 4K 或 8K 分辨率。 使用即梦智能超清模型(jimeng_i2i_seed3_tilesr_cvtob)。

  • image_url: 输入图片 URL(JPEG/PNG,最大 4.7MB,最大 4096×4096)

  • resolution: "4k"(默认)或 "8k"

  • detail: 细节生成程度 0~100(默认 50,越大细节越多但可能偏离原图)

Inputs: image_url (required), detail, resolution. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool targets a distinct media generation or editing task: text-to-image, image-to-image, inpainting, upscaling, text-to-video, image-to-video, motion imitation, digital human creation, and video translation. There is no meaningful overlap between these operations.

    Naming Consistency5/5

    All tool names use a consistent lowercase_snake_case convention with a clear verb_noun or transformation pattern (generate_image, inpaint_image, image_to_video, translate_video). The two image_to_* names follow a predictable transformation pattern, making the set uniform and intuitive.

    Tool Count5/5

    With 9 tools, the server is well-scoped for an AI media generation platform. Each tool covers a distinct capability without redundancy, and the count falls comfortably within the ideal 3-15 range.

    Completeness4/5

    The tool surface covers the core media generation lifecycle: image creation/editing/upscaling, video generation from text or images, motion transfer, digital humans, and video translation. Minor gaps like audio generation or task management are not critical for the stated purpose, but the set is quite comprehensive.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers