Skip to main content
Glama
kira4094

Doubao Vision MCP Server

by kira4094

Doubao Vision MCP Server

npm version

火山方舟(Volcengine Ark)豆包系列 MCP Server:视觉理解 + Seedream 图像生成 + Seedance 视频生成,一套密钥全打通。

特性

  • 🖼️ 4 个工具:视觉理解 / 图像生成 / 视频提交 / 视频轮询

  • 🎬 Seedream 同步出图:图像几秒返回,无需轮询

  • 🎥 Seedance 两段式:异步提交 task_id → 轮询拿视频(MCP stdio 不超时)

  • 💬 自定义 prompt,支持中文/英文

  • 🔄 所有模型可用环境变量切换,代码零改动

  • ⚡ 一行 npx 部署

  • 💰 支持火山方舟赠送的免费 token

Related MCP server: Vision MCP Server

支持的模型

视觉理解

项目

说明

模型 ID

doubao-seed-2-0-mini-260428(默认,DOUBAO_MODEL 可换)

接入点

预置推理接入点(无需创建,直接填模型名)

模态

文本 + 图片 + 语音 + 视频

图像生成(Seedream)

项目

说明

模型 ID

doubao-seedream-5-0-lite-260128(默认,SEEDREAM_MODEL 可换)

图生图

doubao-seededit-3-0-i2i-250628SEEDREAM_I2I_MODEL,传 image 参数自动切换)

备选

doubao-seedream-5-0-pro-260628 / doubao-seedream-4-0-250828 / doubao-seedream-4-5-251128

视频生成(Seedance)

项目

说明

模型 ID

doubao-seedance-2-0-260128(默认,SEEDANCE_MODEL 可换)

备选

doubao-seedance-2-5-260628 / doubao-seedance-2-0-fast-260128 / doubao-seedance-2-0-mini-260615

⚠️ 注意

需在火山方舟控制台开通对应模型doubao-seedance-1-5-pro-251215 已退役(Retiring),API 不接受新任务

环境变量

变量

必填

默认值

说明

ARK_API_KEY

火山方舟 API Key。获取:控制台 → API Key 管理

DOUBAO_MODEL

doubao-seed-2-0-mini-260428

视觉模型名(预置接入点)或 ep-xxxxx

SEEDREAM_MODEL

doubao-seedream-5-0-lite-260128

Seedream 文生图模型

SEEDREAM_I2I_MODEL

doubao-seededit-3-0-i2i-250628

Seedream 图生图模型(传 image 时自动用)

SEEDANCE_MODEL

doubao-seedance-2-0-260128

Seedance 视频生成模型

DOUBAO_BASE_URL

https://ark.cn-beijing.volces.com/api/v3

API 地址,通常无需修改

开通模型(重要)

火山方舟控制台开通管理 开通需要的模型(通常有免费试用额度):

  • 图像生成:Doubao Seedream 系列

  • 视频生成:Doubao Seedance 系列(建议 2.0 / 2.5)

快速开始

npx 部署

{
  "mcpServers": {
    "doubao-vision": {
      "command": "npx",
      "args": ["-y", "doubao-vision-mcp-server"],
      "env": {
        "ARK_API_KEY": "ark-xxxxxxxxx-xxxxx"
      }
    }
  }
}

自定义模型

{
  "mcpServers": {
    "doubao-vision": {
      "command": "npx",
      "args": ["-y", "doubao-vision-mcp-server"],
      "env": {
        "ARK_API_KEY": "ark-xxxxxxxxx-xxxxx",
        "SEEDREAM_MODEL": "doubao-seedream-5-0-pro-260628",
        "SEEDANCE_MODEL": "doubao-seedance-2-5-260628"
      }
    }
  }
}

工具

doubao_vision_understand — 视觉理解

参数

必填

默认值

说明

image

本地图片路径 C:/img.png 或 URL

prompt

对图片的指令,越具体越好

detail

auto

图片精度:auto / low / high

max_tokens

4096

最大输出 token 数

temperature

1

采样温度(0~2)

doubao_seedream_generate — 图像生成(同步)

参数

必填

默认值

说明

prompt

图像描述(中英文皆可)

image

参考图(本地路径/URL),传了即图生图

size

分辨率,如 2048x20481920x1080

ratio

宽高比:1:1 / 3:4 / 4:3 / 16:9 / 9:16

n

1

生成数量

doubao_seedance_generate — 视频生成(异步提交)

参数

必填

默认值

说明

prompt

视频描述

image

参考图(图生视频)

resolution

分辨率(如 720p1080p

duration

时长(秒,模型支持范围 4~30)

返回 task_id,随后用 doubao_seedance_query 轮询。

doubao_seedance_query — 视频生成(轮询)

参数

必填

说明

task_id

doubao_seedance_generate 返回的任务 ID

返回 status(queued / running / succeeded / failed),succeeded 时给出视频下载 URL。

使用示例

分析这张 UI 截图:C:\screenshot.png,描述它的布局和配色方案

生成一张暖色调复古酒吧氛围图,两个人西装对话,电影胶片质感

用这张参考图生成一段 5 秒视频:角色转头看向镜头,微笑(会返回 task_id,再查询)

本地开发

git clone https://github.com/kira4094/doubao-vision-mcp-server.git
cd doubao-vision-mcp-server
npm install
node src/index.js

验证结果

能力

模型

结果

视觉理解

doubao-seed-2-0-mini-260428

图像生成(文生图)

doubao-seedream-5-0-lite-260128

✅ 实测出图

图像生成(图生图)

doubao-seededit-3-0-i2i-250628

✅ 模型已开通

视频生成

doubao-seedance-2-0-260128

⏳ 需控制台开通后启用

关联项目

Install Server
A
license - permissive license
B
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • OCR, transcription, file extraction, and image generation for AI agents via MCP.

  • Generate images with any major model — one API key, one prepaid balance, one MCP.

  • MCP server for ByteDance Seedream AI image generation

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kira4094/doubao-vision-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server