即梦图像/视频生成MCP

Forever17/jimeng_visual_generation
Hosted
4 Stars 1.2k 次浏览 Forever17 更新于 2026-08-23

基于火山引擎 Jimeng 视觉生成 API 的 MCP 服务器,通过模型上下文协议(MCP)提供图像和视频生成功能。支持文本生成图像、图像到图像、多图融合、文本生成视频以及图像到视频等功能,并且自动支持本地文件。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "jimeng_visual_generation": {
      "args": [
        "jimeng_visual_generation"
      ],
      "command": "uvx",
      "env": {
        "VOLC_API_KEY": "your_volcengine_api_key_here",
        "VOLC_IMAGE_MODEL": "doubao-seedream-4.5",
        "VOLC_VIDEO_MODEL": "doubao-seedance-1.5-pro-251215"
      }
    }
  }
}

该服务需要配置环境变量:VOLC_API_KEY、VOLC_IMAGE_MODEL、VOLC_VIDEO_MODEL

可用工具 (3 个)

该服务在 MCP 协议中暴露的工具,AI 可按需调用

generate_image 1 个参数 需填 1 项

Generate images using the Volcengine (Jimeng) API. Capabilities: 1. **Text-to-Image (T2I)**: Provide only `prompt`. 2. **Image-to-Image (I2I)**: Provide `prompt` and one reference image in `image_urls`. 3. **Multi-Image Fusion**: Provide `prompt` and multiple reference images in `image_urls` (only supported by specific models like seedream-4.5). Image Input Format: - **URL**: A publicly accessible HTTP/HTTPS URL. - **Base64**: A data URI string, e.g., `data:image/jpeg;base64,...`. - **Local Path**: Absolute path to a local image file (e.g., `E:/photos/test.jpg`). The server will automatically convert it.

必填参数:params

generate_video 1 个参数 需填 1 项

Create a video generation task. Supports Text-to-Video and Image-to-Video. Modes (Automatically detected based on `image_urls`): 1. **Text-to-Video**: Leave `image_urls` empty. 2. **First Frame I2V**: Provide exactly 1 image. The video will start with this image. 3. **First & Last Frame I2V**: Provide exactly 2 images. The video will generate a transition from the first to the second image. You can provide local file paths (e.g., "C:/images/start.jpg"), and they will be automatically converted to Base64 for the API. Returns: - A **Task ID** string. You must use `get_video_task_result` to query the actual video URL after some time.

必填参数:params

get_video_task_result 1 个参数 需填 1 项

Query the status and result of a video generation task. Usage: - Call this periodically after submitting a video task. - Status values: 'queued', 'running', 'succeeded', 'failed'. - If 'succeeded', returns the final Video URL.

必填参数:params

服务介绍

Jimeng 视觉生成 MCP 服务器

基于 Volcengine(火山引擎)Jimeng 视觉生成 API 的 MCP 服务器。通过模型上下文协议(MCP)提供图像和视频生成功能。

功能

  • 文本生成图像(T2I):根据文本提示生成图像
  • 图像到图像(I2I):基于提示和参考图像对图像进行变换
  • 多图融合:合成多张参考图像
  • 文本生成视频(T2V):根据文本提示生成视频
  • 图像到视频(I2V):从首帧或首帧+末帧图像生成视频
  • 自动本地文件支持:可传入图像公网URL,同时支持本地文件路径,程序会自动将其转换为 Base64

安装

选项 1:通过 pip 安装

pip install jimeng_visual_generation

选项 2:直接使用 uvx 运行(推荐)

无需安装。uvx 会自动下载并运行该包:

uvx jimeng_visual_generation

在 VS Code / Cursor / Claude Desktop 中的配置

将下列内容添加到你的 MCP 配置文件:

  • VS Code~/.vscode/mcp.json 或 工作区设置
  • Cursor:Settings -> MCP Servers
  • Claude Desktop%APPDATA%\Claude\claude_desktop_config.json

示例配置(使用环境变量)

{
  "mcpServers": {
    "jimeng_visual_generation": {
      "command": "uvx",
      "args": ["jimeng_visual_generation"],
      "env": {
        "VOLC_API_KEY": "your_volcengine_api_key_here",
        "VOLC_IMAGE_MODEL": "doubao-seedream-4.5",
        "VOLC_VIDEO_MODEL": "doubao-seedance-1.5-pro-251215"
      }
    }
  }
}

环境变量

变量 是否必需 描述
VOLC_API_KEY ✅ 必需 你的 Volcengine API Key
VOLC_IMAGE_MODEL 可选 图像模型 ID(默认:doubao-seedream-4.5)
VOLC_VIDEO_MODEL 可选 视频模型 ID(默认:doubao-seedance-1.5-pro)

可用工具

generate_image

使用文本提示和可选参考图像生成图像。

参数:

  • prompt(必需):描述目标图像的文本
  • image_urls(可选):参考图像列表(支持 URL、Base64 或本地文件路径)
  • model(可选):使用的模型 ID
  • size(可选):图像尺寸(例如:"2048x2048"、"2K"、"4K")

generate_video

创建视频生成任务。根据输入自动判断模式:

  • 无图像 → 文本生成视频(T2V)
  • 1 张图像 → 首帧 I2V
  • 2 张图像 → 首帧 & 末帧 I2V

参数:

  • prompt(可选):视频描述的文本
  • image_urls(可选):输入图像(支持 URL、Base64 或本地文件路径)
  • model(可选):使用的模型 ID
  • ratio(可选):宽高比(例如:"16:9"、"9:16")
  • duration(可选):视频时长(秒)

get_video_task_result

查询视频生成任务的状态和结果。

参数:

  • task_id(必需):由 generate_video 返回的任务 ID

📄 开源协议 (License)

本项目基于 MIT License 开源。

💖 赞助 (Sponsorship)

维护开源项目不易,如果您觉得 jimeng_visual_generation 对您有帮助,欢迎请作者喝杯咖啡!

平台 链接 支付方式
爱发电 (Afdian) Afdian 微信, 支付宝

相关 MCP 服务