Repository navigation
Releases
v1.4.2 隐私政策与 HTTP 鉴权限流
把豆包网页版的生图能力封装成 MCP 服务,不需要官方 API Key,用你自己的网页登录态直接调用。
下载(按平台选)
| 平台 | 资产 | 形态 |
|---|---|---|
| Windows x64(64 位) | doubao-image-mcp-v1.4.2-windows-x64.zip |
GUI 完整版(含扫码登录) |
| Windows x86(32 位) | doubao-image-mcp-v1.4.2-windows-x86.zip |
GUI 完整版(老机器) |
| Windows ARM64 | doubao-image-mcp-v1.4.2-windows-arm64.zip |
GUI 完整版 |
| macOS Apple Silicon(M 系列) | doubao-image-mcp-v1.4.2-macos-arm64-cli.zip |
命令行版 |
| macOS Intel | doubao-image-mcp-v1.4.2-macos-x64-cli.zip |
命令行版 |
| Linux x64 | doubao-image-mcp-v1.4.2-linux-x64-cli.zip |
命令行版 |
| Linux ARM64 | doubao-image-mcp-v1.4.2-linux-arm64-cli.zip |
命令行版 |
本版更新(v1.4.2)
1. 隐私政策(PRIVACY.md)
中英双语,内容就是把事实写清楚:
- 不收集任何数据:没有埋点、没有崩溃上报、开发者看不到你生成什么
- 登录态(Cookie)明文存在本地
config.json,图片存在你自己选的目录 - 联网只访问三类地址:
*.doubao.com、api.github.com(检查更新)、你显式传入的ref_images - 删
config.json即可清空全部本地数据
2. HTTP 模式:可选令牌鉴权
设置里填「HTTP 访问令牌」后,客户端调用 HTTP 模式必须带:
Authorization: Bearer <你的令牌>
或 ?token=<你的令牌>。令牌比较使用常量时间算法,避免时序侧信道。
留空 = 不鉴权,和以前完全一样(默认只监听 127.0.0.1)。
3. HTTP 模式:可选每分钟限流
设置里填「每分钟请求上限」(0 = 不限制)。超过上限返回:
429 Too Many Requests
Retry-After: 60
这和生图的排队不是一回事:
排队保护豆包账号(每个号同时 1 个任务);限流保护服务本身(防客户端异常刷请求)。
4. 测试
新增:
- 令牌鉴权四个分支(未配置 / 未携带 / 错误 / 正确)
- 限流超过上限返回 429
- HTTP 配置项 JSON 往返(防字段名写错静默丢失)
功能(不变)
- 6 个 MCP 工具:
doubao_image/doubao_login/doubao_verify/doubao_models/doubao_ping/doubao_accounts - 全部工具已声明 MCP 行为注解(readOnly / destructive / idempotent / openWorld)
- 复用同一个对话生图,上下文隔离三档(auto / always / none)
- 两种传输:stdio 与 streamable HTTP
- 多账号排队、扫码登录(Windows 内置 WebView2)
- 自动检查更新
快速开始(Windows)
- 解压后双击
doubao-image-mcp.exe - 点「扫码登录」,用豆包 App 扫码
- 把 GUI 生成的 MCP 配置粘进客户端,重启
快速开始(macOS / Linux 命令行版)
unzip doubao-image-mcp-v1.4.2-macos-arm64-cli.zip -d doubao-image-mcp
cd doubao-image-mcp && chmod +x doubao-image-mcp
./doubao-image-mcp -set-session "<整段 Cookie 或只填 sessionid>"
./doubao-image-mcp -mcp已知限制
- 非官方实现,走网页版接口,服务端改接口随时可能失效
- 免费账号有额度限制;IP 风控冷却约 30 分钟,期间别开豆包网页版
- 图生图走旧通道,比文生图脆弱
- HTTP 模式的令牌与限流默认关闭,公网暴露前请务必配置
v1.4.1 工具行为注解
把豆包网页版的生图能力封装成 MCP 服务,不需要官方 API Key,用你自己的网页登录态直接调用。
下载(按平台选)
| 平台 | 资产 | 形态 |
|---|---|---|
| Windows x64(64 位) | doubao-image-mcp-v1.4.1-windows-x64.zip |
GUI 完整版(含扫码登录) |
| Windows x86(32 位) | doubao-image-mcp-v1.4.1-windows-x86.zip |
GUI 完整版(老机器) |
| Windows ARM64 | doubao-image-mcp-v1.4.1-windows-arm64.zip |
GUI 完整版 |
| macOS Apple Silicon(M 系列) | doubao-image-mcp-v1.4.1-macos-arm64-cli.zip |
命令行版 |
| macOS Intel | doubao-image-mcp-v1.4.1-macos-x64-cli.zip |
命令行版 |
| Linux x64 | doubao-image-mcp-v1.4.1-linux-x64-cli.zip |
命令行版 |
| Linux ARM64 | doubao-image-mcp-v1.4.1-linux-arm64-cli.zip |
命令行版 |
本版更新(v1.4.1)
给全部 6 个工具补上 MCP 行为注解
readOnlyHint / destructiveHint / idempotentHint / openWorldHint
以前我们的工具没有声明这四个 hint,带来的实际问题:
- 部分宿主无法判断「调用前要不要弹确认」,只能一律按有副作用处理
- 第三方目录(M8ven 的 Trust Index 等)会直接记为「缺 hint」并扣分;OpenAI 的 MCP 目录要求四个 hint 全部显式声明,缺一个就可能拒收
现在的取值:
| 工具 | readOnly | destructive | idempotent | openWorld |
|---|---|---|---|---|
doubao_image |
false | false | false | true |
doubao_login |
false | false | false | true |
doubao_verify |
false | false | false | true |
doubao_models |
true | false | true | false |
doubao_ping |
true | false | true | true |
doubao_accounts |
false | true | false | false |
doubao_accounts 的 destructive 为 true,是因为它包含 remove(删除账号)这个不可逆操作。
其它
- 新增测试:用内存传输真实握手,列出工具并断言六个工具都带注解、
readOnlyHint取值正确 config增加LoadAt(dir),测试不再读写用户的真实配置目录
功能(不变)
- 6 个 MCP 工具:
doubao_image/doubao_login/doubao_verify/doubao_models/doubao_ping/doubao_accounts - 复用同一个对话生图,上下文隔离三档(auto / always / none)
- 两种传输:stdio 与 streamable HTTP
- 多账号排队、扫码登录(Windows 内置 WebView2)
- 自动检查更新
快速开始(Windows)
- 解压后双击
doubao-image-mcp.exe - 点「扫码登录」,用豆包 App 扫码
- 把 GUI 生成的 MCP 配置粘进客户端,重启
快速开始(macOS / Linux 命令行版)
unzip doubao-image-mcp-v1.4.1-macos-arm64-cli.zip -d doubao-image-mcp
cd doubao-image-mcp && chmod +x doubao-image-mcp
./doubao-image-mcp -set-session "<整段 Cookie 或只填 sessionid>"
./doubao-image-mcp -mcp已知限制
- 非官方实现,走网页版接口,服务端改接口随时可能失效
- 免费账号有额度限制;IP 风控冷却约 30 分钟,期间别开豆包网页版
- 图生图走旧通道,比文生图脆弱
- HTTP 接口无鉴权,默认只绑
127.0.0.1
v1.4.0 风控滑块验证
把豆包网页版的生图能力封装成 MCP 服务,不需要官方 API Key,用你自己的网页登录态直接调用。
下载(按平台选)
| 平台 | 资产 | 形态 |
|---|---|---|
| Windows x64(64 位) | doubao-image-mcp-v1.4.0-windows-x64.zip |
GUI 完整版(含扫码登录) |
| Windows x86(32 位) | doubao-image-mcp-v1.4.0-windows-x86.zip |
GUI 完整版(老机器) |
| Windows ARM64 | doubao-image-mcp-v1.4.0-windows-arm64.zip |
GUI 完整版 |
| macOS Apple Silicon(M 系列) | doubao-image-mcp-v1.4.0-macos-arm64-cli.zip |
命令行版 |
| macOS Intel | doubao-image-mcp-v1.4.0-macos-x64-cli.zip |
命令行版 |
| Linux x64 | doubao-image-mcp-v1.4.0-linux-x64-cli.zip |
命令行版 |
| Linux ARM64 | doubao-image-mcp-v1.4.0-linux-arm64-cli.zip |
命令行版 |
macOS / Linux 是纯命令行版:MCP、
-set-session、-diagnose等功能完整,但没有图形界面(Wails 的 GUI 需要在该平台上用 cgo 编译,Windows 上无法交叉编译)。
本版更新(v1.4.0)
新增:被风控时可以手动过滑块了
豆包的风控有两档:710022002(限流)和 710022004(人机验证)。以前遇到后者只能干等,现在可以直接在程序里解决:
- MCP 新增工具
doubao_verify:调用后弹出一个豆包窗口(带当前账号的登录态),你随便发条消息触发滑块、拖过去、关掉窗口,再重试doubao_image即可 - GUI 新增「去验证(滑块)」按钮(在「设置」里),效果相同
- 窗口尺寸 920×780,是完整的豆包界面,不是简化版验证页
原理:服务端风控时会在 extra.decision 里给 {"type":"verify", ...},程序识别到就标记「需要验证」;验证本身跑在真正的豆包页面里(页面加载的是字节的 verifycenter 验证 SDK),所以指纹和会话都对得上。
改进:风控提示更准确
- 风控提示现在会先指引你「去验证」,再建议冷却 / 换网络
- 明确写了 冷却期间别开豆包网页版,并解释原因:网页版会持续请求同样的接口,相当于一直在续命风控状态,冷却时间会被拉长
- 旧通道(samantha,图生图走它)以前在原文里出现风控码时不报错,现在也会正确识别成风控
功能
- 6 个 MCP 工具
doubao_image:文生图 / 图生图,一次生成几张就返回几张(路径 + 链接 + 尺寸 + 对话链接)doubao_login:直接从 AI 客户端弹窗扫码登录doubao_verify:被风控时打开窗口,手动过一次滑块doubao_models:列出模型、32 种风格 key、8 种比例doubao_ping:检查登录态,能识别 IP 风控doubao_accounts:账号池 list / switch / enable / disable / remove
- 复用同一个对话:默认开启,失败自动新建;上下文隔离三档(auto / always / none)
- 两种传输:stdio 与 streamable HTTP
- 扫码登录:内置 WebView2 窗口,取 HttpOnly 的
sessionid(Windows) - 多账号:头像 + 昵称、启用开关、拖拽排序、默认账号、自动排队
- 自动检查更新:启动时查 GitHub Releases,界面也有「检查更新」按钮
- 排障:
-diagnose环境自检、-login/-view单窗口模式
快速开始(Windows)
- 解压后双击
doubao-image-mcp.exe - 点「扫码登录」,用豆包 App 扫码(或在 AI 客户端里调用
doubao_login) - 把 GUI 自动生成的 MCP 配置粘进客户端,重启
快速开始(macOS / Linux 命令行版)
unzip doubao-image-mcp-v1.4.0-macos-arm64-cli.zip -d doubao-image-mcp
cd doubao-image-mcp && chmod +x doubao-image-mcp
./doubao-image-mcp -set-session "<整段 Cookie 或只填 sessionid>"
./doubao-image-mcp -mcpmacOS 首次运行可能被 Gatekeeper 拦:
xattr -d com.apple.quarantine ./doubao-image-mcp
已知限制
- 非官方实现,走网页版接口,服务端改接口随时可能失效
- 免费账号有额度限制;IP 风控冷却约 30 分钟,期间别开豆包网页版
- 图生图走旧通道,比文生图脆弱,且拿不到会话 id(这类请求会新建对话)
- HTTP 接口无鉴权,默认只绑
127.0.0.1,不要改成监听局域网
v1.3.0 复用对话与上下文隔离
把豆包网页版的生图能力封装成 MCP 服务,不需要官方 API Key,用你自己的网页登录态直接调用。
下载(按平台选)
| 平台 | 资产 | 形态 |
|---|---|---|
| Windows x64(64 位) | doubao-image-mcp-v1.3.0-windows-x64.zip |
GUI 完整版(含扫码登录) |
| Windows x86(32 位) | doubao-image-mcp-v1.3.0-windows-x86.zip |
GUI 完整版(老机器) |
| Windows ARM64 | doubao-image-mcp-v1.3.0-windows-arm64.zip |
GUI 完整版 |
| macOS Apple Silicon(M 系列) | doubao-image-mcp-v1.3.0-macos-arm64-cli.zip |
命令行版 |
| macOS Intel | doubao-image-mcp-v1.3.0-macos-x64-cli.zip |
命令行版 |
| Linux x64 | doubao-image-mcp-v1.3.0-linux-x64-cli.zip |
命令行版 |
| Linux ARM64 | doubao-image-mcp-v1.3.0-linux-arm64-cli.zip |
命令行版 |
macOS / Linux 是纯命令行版:MCP、
-set-session、-diagnose等功能完整,但没有图形界面(Wails 的 GUI 需要在该平台上用 cgo 编译,Windows 上无法交叉编译)。
本版更新(v1.3.0)
新增:复用同一个对话生图(默认开启)
以前每调一次 doubao_image,豆包网页版里就多一个对话。现在:
- 第一次生成时记住会话 id,之后的生成追加到同一个对话里
- 找不到记录、或对话已失效 → 自动新建对话重发一次,并记下新 id
- 每个账号各记各的(
config.json里的chatId/chatSection/chatIndex) - 在「设置 → 复用对话」里可以关掉;MCP 侧可用
new_chat: true单次强制新建
新增:上下文隔离(三档,默认自动)
复用对话意味着新提示词会看到之前的图,所以加了一段提示词做隔离:
| 模式 | 注入的提示词开头 | 适用 |
|---|---|---|
auto(默认) |
「如果下面的生图请求与之前的内容无关,请忽略上文、只按新提示词生成;如果与之前有关联(同一主体换风格/换角度),可以沿用上文信息:」 | 让模型自己判断 |
always |
「这是一次全新的生图请求,与之前生成的内容没有任何关联。请忽略上面的全部上下文,只根据下面的提示词生成图片:」 | 完全独立的新图 |
none |
原样发送,不注入 | 想连续改同一张图 |
设置里可选,也可用 context_mode 参数单次覆盖。
doubao_image 新增参数与返回
new_chat:强制新建对话chat_id:指定会话,纯 id 和对话链接都收(https://www.doubao.com/chat/<id>)context_mode:none/always/auto- 返回新增
chat_id与chat_url,GUI 里还会显示「打开对话 ↗」,点一下就能在浏览器里看那张图所在的对话
解析加固
- 会话 id 改为从
SSE_ACK事件的ack_client_meta结构化提取(正则只做兜底),避免响应里出现别的对话 id 时抓错 - 继续对话时按网页版带上
last_message_index,上下文衔接更接近真实客户端 - 旧通道(samantha 兜底 / 图生图)拿不到会话 id 时清掉本地记录,不会拿着失效 id 反复失败
其它
- 官方文档补充「会话复用与上下文隔离」一节
功能
- 5 个 MCP 工具
doubao_login:直接从 AI 客户端弹窗扫码登录doubao_image:文生图 / 图生图,一次生成几张就返回几张(本地路径 + CDN 链接 + 尺寸 + 对话链接)doubao_models:列出模型、32 种风格 key、8 种比例doubao_ping:检查登录态,能识别 IP 风控doubao_accounts:账号池 list / switch / enable / disable / remove
- 两种传输:stdio 与 streamable HTTP
- 扫码登录:内置 WebView2 窗口,取 HttpOnly 的
sessionid(Windows) - 多账号:头像 + 昵称、启用开关、拖拽排序、默认账号,生图自动排队
- 自动检查更新:启动时查 GitHub Releases,界面右上角也有「检查更新」按钮
- 排障:
-diagnose环境自检、-login/-view单窗口模式
快速开始(Windows)
- 解压后双击
doubao-image-mcp.exe - 点「扫码登录」,用豆包 App 扫码(或在 AI 客户端里调用
doubao_login) - 把 GUI 自动生成的 MCP 配置粘进客户端,重启
快速开始(macOS / Linux 命令行版)
unzip doubao-image-mcp-v1.3.0-macos-arm64-cli.zip -d doubao-image-mcp
cd doubao-image-mcp && chmod +x doubao-image-mcp
./doubao-image-mcp -set-session "<整段 Cookie 或只填 sessionid>"
./doubao-image-mcp -mcpmacOS 首次运行可能被 Gatekeeper 拦:
xattr -d com.apple.quarantine ./doubao-image-mcp
已知限制
- 非官方实现,走网页版接口,服务端改接口随时可能失效
- 免费账号有额度限制;触发 IP 风控(
710022002/710022004)需冷却约 30 分钟 - 图生图走旧通道,比文生图脆弱,且拿不到会话 id(这类请求会新建对话)
- HTTP 接口无鉴权,默认只绑
127.0.0.1,不要改成监听局域网
v1.2.0 自动检查更新
把豆包网页版的生图能力封装成 MCP 服务,不需要官方 API Key,用你自己的网页登录态直接调用。
下载(按平台选)
| 平台 | 资产 | 形态 |
|---|---|---|
| Windows x64(64 位) | doubao-image-mcp-v1.2.0-windows-x64.zip |
GUI 完整版(含扫码登录) |
| Windows x86(32 位) | doubao-image-mcp-v1.2.0-windows-x86.zip |
GUI 完整版(老机器) |
| Windows ARM64 | doubao-image-mcp-v1.2.0-windows-arm64.zip |
GUI 完整版 |
| macOS Apple Silicon(M 系列) | doubao-image-mcp-v1.2.0-macos-arm64-cli.zip |
命令行版 |
| macOS Intel | doubao-image-mcp-v1.2.0-macos-x64-cli.zip |
命令行版 |
| Linux x64 | doubao-image-mcp-v1.2.0-linux-x64-cli.zip |
命令行版 |
| Linux ARM64 | doubao-image-mcp-v1.2.0-linux-arm64-cli.zip |
命令行版 |
macOS / Linux 是纯命令行版:MCP、
-set-session、-diagnose等功能完整,但没有图形界面(Wails 的 GUI 需要在该平台上用 cgo 编译,Windows 上无法交叉编译)。
本版更新(v1.2.0)
新增:自动检查新版本(走 GitHub Releases,不需要任何服务器)
-
界面启动时静默查一次最新版本,有新版本就在顶部弹出提示条:「去下载」直接打开下载页,「忽略此版本」记在本地,下次发版还会提醒
-
界面右上角新增 「检查更新」按钮:手动查一次,检查期间按钮显示转圈 +「检查中」且不可重复点击,结束后显示「有新版本 / 已是最新 / 检查失败」
-
命令行新增两个开关:
.\doubao-image-mcp.exe -version # 打印当前版本,例如 v1.2.0 .\doubao-image-mcp.exe -check-update # 查 GitHub 上有没有新版本
-
版本号由打包时注入(
-ldflags -X .../internal/version.Version=...),本地go build出来的dev版本不会提示更新 -
断网或 GitHub 限流只写日志,不影响生图和界面
新增:项目官网 https://haikuotianko.github.io/doubao-image-mcp/(GitHub Pages,含自动生成的下载列表)
修正
- MCP 服务返回的版本号不再是硬编码的
1.0.0,改为真实版本 - 检查更新时日志会重复一行的问题
功能
- 5 个 MCP 工具
doubao_login:直接从 AI 客户端弹窗扫码登录,不用切到 GUIdoubao_image:文生图 / 图生图,一次生成几张就返回几张(本地路径 + CDN 链接 + 尺寸)doubao_models:列出模型、32 种风格 key、8 种比例doubao_ping:检查登录态,能识别 IP 风控doubao_accounts:账号池 list / switch / enable / disable / remove
- 两种传输:stdio(客户端拉起进程)与 streamable HTTP(
/mcp,常驻多客户端共用) - 扫码登录:内置 WebView2 窗口,取 HttpOnly 的
sessionid(Windows) - 多账号:头像 + 昵称、启用开关、拖拽排序、默认账号;生图请求自动排队到空闲账号,每个账号同时只跑一个任务
- GUI:测试生图、多图缩略图、点击看大图、另存到任意目录
- 排障:
-diagnose环境自检、-login/-view单窗口模式、失败时窗口内显示原因并落盘日志 - 登录态导入:
-set-session支持整段 Cookie、Copy as cURL、或只填sessionid
快速开始(Windows)
- 解压后双击
doubao-image-mcp.exe - 点「扫码登录」,用豆包 App 扫码(或在 AI 客户端里调用
doubao_login) - 把 GUI 自动生成的 MCP 配置粘进客户端,重启
快速开始(macOS / Linux 命令行版)
unzip doubao-image-mcp-v1.2.0-macos-arm64-cli.zip -d doubao-image-mcp
cd doubao-image-mcp && chmod +x doubao-image-mcp
./doubao-image-mcp -set-session "<整段 Cookie 或只填 sessionid>"
./doubao-image-mcp -mcpmacOS 首次运行可能被 Gatekeeper 拦:
xattr -d com.apple.quarantine ./doubao-image-mcp
已知限制
- 非官方实现,走网页版接口,服务端改接口随时可能失效
- 免费账号有额度限制;触发 IP 风控(
710022002/710022004)需冷却约 30 分钟 - 图生图走旧通道,比文生图脆弱
- HTTP 接口无鉴权,默认只绑
127.0.0.1,不要改成监听局域网
v1.1.0 全平台版本
把豆包网页版的生图能力封装成 MCP 服务,不需要官方 API Key,用你自己的网页登录态直接调用。
下载(按平台选)
| 平台 | 资产 | 形态 |
|---|---|---|
| Windows x64(64 位) | doubao-image-mcp-v1.1.0-windows-x64.zip |
GUI 完整版(含扫码登录) |
| Windows x86(32 位) | doubao-image-mcp-v1.1.0-windows-x86.zip |
GUI 完整版(老机器) |
| Windows ARM64 | doubao-image-mcp-v1.1.0-windows-arm64.zip |
GUI 完整版 |
| macOS Apple Silicon(M 系列) | doubao-image-mcp-v1.1.0-macos-arm64-cli.zip |
命令行版 |
| macOS Intel | doubao-image-mcp-v1.1.0-macos-x64-cli.zip |
命令行版 |
| Linux x64 | doubao-image-mcp-v1.1.0-linux-x64-cli.zip |
命令行版 |
| Linux ARM64 | doubao-image-mcp-v1.1.0-linux-arm64-cli.zip |
命令行版 |
命名沿用大家熟悉的
x64/x86/arm64叫法。
macOS / Linux 是纯命令行版:MCP、-set-session、-diagnose等功能完整,但没有图形界面(Wails 的 GUI 需要在该平台上用 cgo 编译,Windows 上无法交叉编译)。
本版更新(v1.1.0)
- 登录态导入支持整段 Cookie:
-set-session和 GUI 的导入框现在三种格式都认——- 完整 Cookie 头:
sessionid=…; ttwid=…; passport_csrf_token=… - 浏览器「复制为 cURL」整条粘进来(自动从
-H 'cookie: …'/-b '…'里提取) - 只填
sessionid=…
- 完整 Cookie 头:
- macOS / Linux 手动导入说明写得更细(Chrome / Edge / Safari / Firefox 各自怎么取 Cookie),见 README
- Release 资产名统一成
windows-x64/windows-x86/macos-arm64-cli这类常规写法,并修正了 Release 标题乱码
功能
- 5 个 MCP 工具
doubao_login:直接从 AI 客户端弹窗扫码登录,不用切到 GUIdoubao_image:文生图 / 图生图,一次生成几张就返回几张(本地路径 + CDN 链接 + 尺寸)doubao_models:列出模型、32 种风格 key、8 种比例doubao_ping:检查登录态,能识别 IP 风控doubao_accounts:账号池 list / switch / enable / disable / remove
- 两种传输:stdio(客户端拉起进程)与 streamable HTTP(
/mcp,常驻多客户端共用) - 扫码登录:内置 WebView2 窗口,取 HttpOnly 的
sessionid(Windows) - 多账号:头像 + 昵称、启用开关、拖拽排序、默认账号;生图请求自动排队到空闲账号,每个账号同时只跑一个任务
- GUI:测试生图、多图缩略图、点击看大图、另存到任意目录
- 排障:
-diagnose环境自检、-login/-view单窗口模式、失败时窗口内显示原因并落盘日志
快速开始(Windows)
- 解压后双击
doubao-image-mcp.exe - 点「扫码登录」,用豆包 App 扫码(或在 AI 客户端里调用
doubao_login) - 把 GUI 自动生成的 MCP 配置粘进客户端,重启
快速开始(macOS / Linux 命令行版)
unzip doubao-image-mcp-v1.1.0-macos-arm64-cli.zip -d doubao-image-mcp
cd doubao-image-mcp && chmod +x doubao-image-mcp
./doubao-image-mcp -set-session "<整段 Cookie 或只填 sessionid>"
./doubao-image-mcp -mcpmacOS 首次运行可能被 Gatekeeper 拦:
xattr -d com.apple.quarantine ./doubao-image-mcp
已知限制
- 非官方实现,走网页版接口,服务端改接口随时可能失效
- 免费账号有额度限制;触发 IP 风控(
710022002/710022004)需冷却约 30 分钟 - 图生图走旧通道,比文生图脆弱
- HTTP 接口无鉴权,默认只绑
127.0.0.1,不要改成监听局域网
v1.0.0 首个可用版本
把豆包网页版的生图能力封装成 MCP 服务,不需要官方 API Key,用你自己的网页登录态直接调用。
下载(按平台选)
| 平台 | 资产 | 形态 |
|---|---|---|
| Windows x64 | doubao-image-mcp-v1.0.0-windows-amd64.zip |
GUI 完整版(含扫码登录) |
| Windows ARM64 | doubao-image-mcp-v1.0.0-windows-arm64.zip |
GUI 完整版 |
| Windows x86(32 位) | doubao-image-mcp-v1.0.0-windows-386.zip |
GUI 完整版(老机器) |
| macOS Apple Silicon | doubao-image-mcp-v1.0.0-darwin-arm64-cli.zip |
命令行版 |
| macOS Intel | doubao-image-mcp-v1.0.0-darwin-amd64-cli.zip |
命令行版 |
| Linux x64 | doubao-image-mcp-v1.0.0-linux-amd64-cli.zip |
命令行版 |
| Linux ARM64 | doubao-image-mcp-v1.0.0-linux-arm64-cli.zip |
命令行版 |
macOS / Linux 是纯命令行版:MCP、
-set-session、-diagnose等功能完整,但没有图形界面(Wails 的 GUI 需要在该平台上用 cgo 编译,Windows 上无法交叉编译)。
功能
- 5 个 MCP 工具
doubao_login:直接从 AI 客户端弹窗扫码登录,不用切到 GUIdoubao_image:文生图 / 图生图,一次生成几张就返回几张(本地路径 + CDN 链接 + 尺寸)doubao_models:列出模型、32 种风格 key、8 种比例doubao_ping:检查登录态,能识别 IP 风控doubao_accounts:账号池 list / switch / enable / disable / remove
- 两种传输:stdio(客户端拉起进程)与 streamable HTTP(
/mcp,常驻多客户端共用) - 扫码登录:内置 WebView2 窗口,取 HttpOnly 的
sessionid(Windows) - 多账号:头像 + 昵称、启用开关、拖拽排序、默认账号;生图请求自动排队到空闲账号,每个账号同时只跑一个任务
- GUI:测试生图、多图缩略图、点击看大图、另存到任意目录
- 排障:
-diagnose环境自检、-login/-view单窗口模式、失败时窗口内显示原因并落盘日志
快速开始(Windows)
- 解压后双击
doubao-image-mcp.exe - 点「扫码登录」,用豆包 App 扫码(或在 AI 客户端里调用
doubao_login) - 把 GUI 自动生成的 MCP 配置粘进客户端,重启
快速开始(macOS / Linux 命令行版)
unzip doubao-image-mcp-v1.0.0-darwin-arm64-cli.zip -d doubao-image-mcp
cd doubao-image-mcp && chmod +x doubao-image-mcp
./doubao-image-mcp -set-session "<从浏览器 Cookie 复制的 sessionid>"
./doubao-image-mcp -mcp已知限制
- 非官方实现,走网页版接口,服务端改接口随时可能失效
- 免费账号有额度限制;触发 IP 风控(
710022002/710022004)需冷却约 30 分钟 - 图生图走旧通道,比文生图脆弱
- HTTP 接口无鉴权,默认只绑
127.0.0.1,不要改成监听局域网