Skip to content

Releases

v1.4.2 隐私政策与 HTTP 鉴权限流

Choose a tag to compare

@haikuotianko haikuotianko released this 19 Nov 01:41

把豆包网页版的生图能力封装成 MCP 服务,不需要官方 API Key,用你自己的网页登录态直接调用。

官网 / 下载页:https://haikuotianko.github.io/doubao-image-mcp/

下载(按平台选)

平台 资产 形态
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)

  1. 解压后双击 doubao-image-mcp.exe
  2. 点「扫码登录」,用豆包 App 扫码
  3. 把 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 工具行为注解

Choose a tag to compare

@haikuotianko haikuotianko released this 18 Nov 07:21

把豆包网页版的生图能力封装成 MCP 服务,不需要官方 API Key,用你自己的网页登录态直接调用。

官网 / 下载页:https://haikuotianko.github.io/doubao-image-mcp/

下载(按平台选)

平台 资产 形态
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)

  1. 解压后双击 doubao-image-mcp.exe
  2. 点「扫码登录」,用豆包 App 扫码
  3. 把 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 风控滑块验证

Choose a tag to compare

@haikuotianko haikuotianko released this 09 Nov 09:33

把豆包网页版的生图能力封装成 MCP 服务,不需要官方 API Key,用你自己的网页登录态直接调用。

官网 / 下载页:https://haikuotianko.github.io/doubao-image-mcp/

下载(按平台选)

平台 资产 形态
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)

  1. 解压后双击 doubao-image-mcp.exe
  2. 点「扫码登录」,用豆包 App 扫码(或在 AI 客户端里调用 doubao_login)
  3. 把 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 -mcp

macOS 首次运行可能被 Gatekeeper 拦:xattr -d com.apple.quarantine ./doubao-image-mcp

已知限制

  • 非官方实现,走网页版接口,服务端改接口随时可能失效
  • 免费账号有额度限制;IP 风控冷却约 30 分钟,期间别开豆包网页版
  • 图生图走旧通道,比文生图脆弱,且拿不到会话 id(这类请求会新建对话)
  • HTTP 接口无鉴权,默认只绑 127.0.0.1,不要改成监听局域网

v1.3.0 复用对话与上下文隔离

Choose a tag to compare

@haikuotianko haikuotianko released this 09 Nov 07:05

把豆包网页版的生图能力封装成 MCP 服务,不需要官方 API Key,用你自己的网页登录态直接调用。

官网 / 下载页:https://haikuotianko.github.io/doubao-image-mcp/

下载(按平台选)

平台 资产 形态
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)

  1. 解压后双击 doubao-image-mcp.exe
  2. 点「扫码登录」,用豆包 App 扫码(或在 AI 客户端里调用 doubao_login)
  3. 把 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 -mcp

macOS 首次运行可能被 Gatekeeper 拦:xattr -d com.apple.quarantine ./doubao-image-mcp

已知限制

  • 非官方实现,走网页版接口,服务端改接口随时可能失效
  • 免费账号有额度限制;触发 IP 风控(710022002 / 710022004)需冷却约 30 分钟
  • 图生图走旧通道,比文生图脆弱,且拿不到会话 id(这类请求会新建对话)
  • HTTP 接口无鉴权,默认只绑 127.0.0.1,不要改成监听局域网

v1.2.0 自动检查更新

Choose a tag to compare

@haikuotianko haikuotianko released this 07 Nov 02:41

把豆包网页版的生图能力封装成 MCP 服务,不需要官方 API Key,用你自己的网页登录态直接调用。

官网 / 下载页:https://haikuotianko.github.io/doubao-image-mcp/

下载(按平台选)

平台 资产 形态
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 客户端弹窗扫码登录,不用切到 GUI
    • doubao_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)

  1. 解压后双击 doubao-image-mcp.exe
  2. 点「扫码登录」,用豆包 App 扫码(或在 AI 客户端里调用 doubao_login)
  3. 把 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 -mcp

macOS 首次运行可能被 Gatekeeper 拦:xattr -d com.apple.quarantine ./doubao-image-mcp

已知限制

  • 非官方实现,走网页版接口,服务端改接口随时可能失效
  • 免费账号有额度限制;触发 IP 风控(710022002 / 710022004)需冷却约 30 分钟
  • 图生图走旧通道,比文生图脆弱
  • HTTP 接口无鉴权,默认只绑 127.0.0.1,不要改成监听局域网

v1.1.0 全平台版本

Choose a tag to compare

@haikuotianko haikuotianko released this 06 Nov 09:19

把豆包网页版的生图能力封装成 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=…
  • macOS / Linux 手动导入说明写得更细(Chrome / Edge / Safari / Firefox 各自怎么取 Cookie),见 README
  • Release 资产名统一成 windows-x64 / windows-x86 / macos-arm64-cli 这类常规写法,并修正了 Release 标题乱码

功能

  • 5 个 MCP 工具
    • doubao_login:直接从 AI 客户端弹窗扫码登录,不用切到 GUI
    • doubao_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)

  1. 解压后双击 doubao-image-mcp.exe
  2. 点「扫码登录」,用豆包 App 扫码(或在 AI 客户端里调用 doubao_login)
  3. 把 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 -mcp

macOS 首次运行可能被 Gatekeeper 拦:xattr -d com.apple.quarantine ./doubao-image-mcp

已知限制

  • 非官方实现,走网页版接口,服务端改接口随时可能失效
  • 免费账号有额度限制;触发 IP 风控(710022002 / 710022004)需冷却约 30 分钟
  • 图生图走旧通道,比文生图脆弱
  • HTTP 接口无鉴权,默认只绑 127.0.0.1,不要改成监听局域网

v1.0.0 首个可用版本

Choose a tag to compare

@haikuotianko haikuotianko released this 06 Nov 09:01

把豆包网页版的生图能力封装成 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 客户端弹窗扫码登录,不用切到 GUI
    • doubao_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)

  1. 解压后双击 doubao-image-mcp.exe
  2. 点「扫码登录」,用豆包 App 扫码(或在 AI 客户端里调用 doubao_login)
  3. 把 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,不要改成监听局域网