Skip to main content
Glama
ganmayou2333

dsh-mcp-connector

by ganmayou2333
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

dsh-ai-bridge

把外部 AI 客户端和**本机 DeepSeek Harness（DSH）**接起来的两件小工具，零依赖，不动 DSH 本体。

English

Two zero-dependency tools that bridge external AI clients and a local DeepSeek Harness (DSH): an MCP server that lets any MCP-capable client send messages into DSH, and a CDP driver that dispatches tasks into the Doubao desktop app.

外部 AI 客户端 ──MCP──▶ dsh-mcp-connector ──▶ dsh --profile headless ──▶ DSH
   (Claude Code / Cursor / VS Code / Codex / Kimi Code / CodeBuddy / Qoder / TRAE /
    ZCode / Step Code / MiniMax Code / Coze …)

DSH / 脚本 / HTTP ──入队──▶ tasks.jsonl ──task_claim──▶ 任意 MCP 客户端（拉取式任务队列）

脚本 / DSH ──CDP──▶ doubao-cdp ──▶ 豆包桌面版（把任务下发进它的聊天框）

为什么需要它

DSH 随发行体只带了 MCP 客户端（dsh-mcp-client），没有 MCP server 半区；它的 Web API 又需要浏览器 cookie 与 Host/Origin 围栏，第三方程序难以直接持有。所以「让别的 AI 给 DSH 发消息」必须有一个独立桥——这就是本仓库的第一个工具。

反方向（把任务下发给别家 AI）没有任何官方入站 API，只能走 GUI 自动化——这是第二个工具。

而 MCP 工具只在客户端自己的回合里执行，推送不进去；所以真正能自动化的派活方式是拉取：生产者入队，客户端领取。这部分已经做进第一个工具（task_claim / task_complete / task_publish / task_list + POST /tasks）。

Related MCP server: dsh-harness-mcp-server

目录

路径

作用

dsh-mcp-connector/

MCP server（stdio + Streamable HTTP 双传输），暴露 dsh_ask / dsh_cli_info / connector_status 与四个任务队列工具，驱动 dsh --profile headless

doubao-cdp/

用 Chrome DevTools Protocol 驱动豆包桌面版（Electron）：cdp.mjs 下发并读回，dispatch.mjs 带副作用校验的派发（拒绝相信客户端的自述）

doubao-status-panel/（豆包控制器 / Doubao Controller，包 id 仍是 @local/doubao-status-panel）

DSH Web 侧栏控制器：任务状态（已接收 → 工作开始 → 进行中 → 已完成）、豆包当前模式与模型（含 0921 新版 / 即将下线 标注）、5h 与 7d 两个额度窗口（各一条 5px 进度条，≥80% 琥珀 / ≥95% 红）。不是工作模式时给一个「切到工作」按钮。宿主半是只读 GET /doubao-status/api 加只放行本机的 POST /doubao-status/api/mode，复用 DSH 自己的 web 端口，不新开监听；额度（额度页三次点击，失败降级到账户菜单）与模型清单是采样，与模式切换共用一条串行队列，采样频率可在设置里调

skills/dsh-mcp-connector/

给 AI agent 用的技能包：18 个 MCP 客户端的配置矩阵（含豆包工作 App 内自定义连接器）、陷阱表、以及「未证实项」清单

docs/design-notes.md

设计说明：为什么必须有独立的桥、DSH 的五个机器入口面、队列为何是拉取式、两个方向的合规结论、已知失败模式

scripts/register.mjs

注册助手：把连接器写进各 MCP 客户端的配置文件，不用手抄 JSON/TOML；--client doubao-work 打印豆包工作要粘贴的 HTTP 配置

scripts/check-doubao-work.mjs

豆包工作接线体检（对应豆包本体的 cdp.mjs doctor）：端点 / 客户端 / 状态通道 / 队列 / 常驻 / 推送 六维，只读；退出码 0 就绪 / 3 未就绪 / 8 无法判定

scripts/dispatch-work.mjs

拉取式派发器（对应豆包本体的 dispatch.mjs --queue）：先前置确认再入队，确认不过退 3 且不留孤儿任务；判定只看队列的 complete 事件。退出码 0 / 2 超时 / 3 / 5

scripts/accept-doubao-work.mjs

豆包工作这条线的一条命令验收：接线就绪 + 任务真被完成 + 结果里带回标记（只有 complete、没有标记不算通过）+ 状态通道增量；--preflight-only 只查就绪、不入队。退出码 0 / 2 未完成 / 3 / 5

各自的使用方法见对应 README。

快速开始

git clone https://github.com/ganmayou2333/dsh-ai-bridge
cd dsh-ai-bridge

npm test                       # 两套密封测试：不需要 DSH，也不需要豆包

cd dsh-mcp-connector
node selftest.mjs              # 完整自测（多跑两项需要本机 DSH 的检查）

# 然后在你的 MCP 客户端里加一条 stdio server：
#   命令: node
#   参数: <你的路径>/dsh-ai-bridge/dsh-mcp-connector/server.mjs
#   环境: DSH_BIN=<dsh 可执行文件>   DSH_WORKSPACE=<DSH 会话工作目录>
# 逐客户端配置见 dsh-mcp-connector/README.md

用注册助手代替手抄配置

node scripts/register.mjs --list                       # 看每个客户端的配置文件位置与注册状态
node scripts/register.mjs --client cursor --dry-run    # 只打印将要写入的内容，不落盘
node scripts/register.mjs --client vscode              # 写入（已存在的文件会先备份成 .bak）
node scripts/register.mjs --client all --dry-run       # 一次看全部

支持的客户端与各自的坑都编码在里面（ZCode 的 mcp.servers、Step Code 的 TOML、CodeBuddy/MiniMax 必须显式 type: stdio、VS Code 的 servers）。claude-code 是 CLI 管理的，脚本不写文件，只打印该运行的 claude mcp add 命令。

写入前建议先 --dry-run 看一眼；测试用 --root/--project 重定向到临时目录，不会碰你的真实配置。

要求：Node ≥ 20（本机用 v24 验证）、一个可用的 DSH 安装（dsh 命令）。

验证状态

项

证据

dsh-mcp-connector 自测

61 项断言全过，退出码 0（密封 DSH_HOME 下 headless profile 首次初始化、stdio 往返、HTTP 鉴权 401/403/404/405/202、生产者路由 201、队列语义与 6 路并发领取无碰撞、自观测与流水线握手闸门）

离线自测（CI 用）

58 项通过 / 2 项跳过，退出码 0；跳过的两项需要本机装好 DSH。工作流见 .github/workflows/ci.yml，矩阵为 Ubuntu/Windows × Node 20/24

真实模型调用

一条消息 3.7 秒返回，拿到 sessionId；带该 id 再发一条成功续接同一会话

真实 MCP 客户端握手

Claude Code 2.1.226 完成握手并协商到协议 2025-11-25，证据是连接器自己记录的 clients.json（该客户端当时未登录，故工具调用未执行）

doubao-cdp 真实往返

连续 3 次下发-回传成功，最后一次为 send + wait 单次调用完成

dispatch.mjs 校验逻辑

成功路径（队列完成 → 退出 0 VERIFIED）与失败路径（客户端嘴上说做了、队列仍 pending → 退出 2 UNVERIFIED）双向实测；密封测试 35 项断言全过（含指令内容、状态契约、实时状态、无 started 的完成、发送前预检、--no-send 不写 received、发送后 wait/read 带 --no-preflight），不需要豆包与 CDP

豆包启动确认

42 项断言全过：端口关闭 / 端口通但无匹配页面 / 就绪 / --no-preflight 逃生门 四种状态，外加「确认失败不得留下孤儿任务」、模型控件文字的拆分（豆包 2.1 Lite低 里的档位不是模型名）、state 是读数不是闸门（豆包没开也退 0 并报 connected:false）、mode 的非法目标在连 CDP 之前就被挡住且离线时明确报失败、quota/models 在豆包没开时退 1 且 ok:false（不猜数字、不编号清单）、额度页文本的解析（真机原文：两个窗口、已用 <1% 读成 0 + approximate 而不是 1%、重置时间与次数、不是额度页就 0 个窗口）。用假 CDP 端点密封测，不需要豆包

状态回报

34 项断言全过：固定词表与别名、ini 开关、被关掉的状态静默 no-op、限流（关键状态永不丢）、截断、终态不可覆盖、崩溃半行、时间线排序、忙闲与疑似卡死；received（派发器写的发送侧事实）的写入 / 折叠 / 被 started 覆盖 / 未开工也算「忙」

调用前五维识别

23 项断言全过：连通 / 模式 / 命令能力 / 忙闲 / 通道，三态区分（0 可发 / 3 未就绪 / 8 无法识别），模式不匹配与忙闲都拒绝，--force 放行并留 override 记录

状态推送（P2）

16 项断言全过：只推阶段转换（progress 不推）、游标幂等、新增事件会推、缺会话时明确报错、--create-session 只建一次会话

豆包控制器（DSH Web 侧栏徽章）

118 项断言全过：received 折叠、只读接口（405 且不触发读取）、来源围栏、单一路由、源码不起监听、清单与模块装载器形态、DSH_HOME 回退、运行时快照与 15 秒缓存、模式切换端点、额度/模型采样（解析、越界夹取、没有数字就 ok:false 不猜、同名去重、多窗口载荷、降级标记、<1% 读成 0 而不是 1）、菜单互斥串行队列、采样设置（夹在 30 秒..1 小时、缺参数回退默认、sample=0 不刷新、设置透传），以及用假 React 真跑 client.js 的渲染断言（没任务=1 条进度条、progress 55%=2 条且三行齐全、started 无百分比=不画任务条、done=满格、额度 ≥95%=error 色、两个额度窗口=两条行两条 5px 条、有任务时共 3 条）。真机（2026-10-1011）：GET 200 JSON、POST 405、非回环 Host 403；徽章、额度行、采样设置项均经用户界面确认；一条真任务在工作模式下跑出 received → started → done；cdp.mjs mode chat|work 双向切换真机成功并用只读 state 复核；cdp.mjs quota → 5h <1%（3 小时 31 分后重置）+ 7d 2%（10月17日 16:42 重置）、plan:"标准套餐"、resets:1，降级路径也实测过；cdp.mjs models → 3 项含 即将下线；读完弹层 0、残留 iframe 0、豆包未被改动。界面上的 5h 额度 <1% / 7d 额度 2% 两行 + 各一条 5px 进度条已由用户目视确认。额度页那条坐标链修了两个真缺陷（读目标失败即放弃、动画期间就点）后 **6/6 成功、2.33.8 秒/次**，定位靠 DOUBAO_QUOTA_DEBUG=1 调试开关

统一入口

仓库根 npm test = 连接器离线自测 + 派发器 + 豆包确认 + 状态 + 状态推送 + 状态面板 + 注册助手 + 拉取式派发器 + 接线验收，共九套，退出码 0

自测默认不产生模型费用；DSH_MCP_CONNECTOR_LIVE=1 node selftest.mjs 会追加一次真实调用。

安全须知

  • dsh-mcp-connector 的 stdio 模式由客户端进程本身充当信任边界；HTTP 模式强制 Bearer token，默认只绑 127.0.0.1，未列入白名单的 Origin 一律 403。要上公网请再套 TLS 反向代理并换掉示例 token。

  • 外部投递的消息在 DSH 内以 {kind:"user"} 进入会话，与真人输入不可区分——请让下游在任务文本里自带来源标记。

  • 不要相信任何 AI 客户端的"我已经调用了工具"。实测：豆包在连接器未启用时会回复「已调用 task_claim，status 为 ok」，而队列里那条任务仍是 pending。核实副作用（队列事件、文件、日志）才是唯一证据——doubao-cdp/dispatch.mjs 就是按这个原则写的。

  • doubao-cdp 需要给豆包加 --remote-debugging-port，这意味着本机任何进程都能接管你的豆包（读聊天、以你身份发消息）。不用时退出并正常启动。

  • 两者都只做消息投递：不要把外部订阅凭证当作 DSH 的模型后端，那违反各家消费者条款。

许可

MIT，见 LICENSE。

| scripts/doubao-work-debug.mjs | 让豆包工作带调试端口跑起来（它只在启动时决定是否可被读/驱动）：--status 只读查状态、--launch 没跑才启动、--restart 才关它再拉起（会打断它正在做的事）。用 WMI 拉起，脱离 DSH 进程树 |

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Test MCP Server

    mokesmokane
    F
    license
    Not graded
    quality
    D
    maintenance
    A dual-transport MCP server that exposes your API as tools to LLM clients, supporting both stdio transport for local clients like Claude Desktop and HTTP/SSE transport for remote clients like OpenAI's Responses API.
    -

  • dsh-harness-mcp-server

    chushixixin
    A
    license
    Not graded
    quality
    A
    maintenance
    Exposes DeepSeek Harness agent capabilities as an MCP server, letting any MCP client drive Harness to execute real coding tasks with structured results, context isolation, and parallel execution.
    83 npm
    13
    MIT

  • hermes-dsh-bridge

    Emilia-awa
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables external MCP clients to drive DeepSeek Harness agents for real coding tasks, providing tools for task execution and queueing, session management, sandboxed file access, preset switching, and usage statistics.
    361 npm
    6
    GPL 3.0

  • dsh

    xDJTomato
    A
    license
    Not graded
    quality
    A
    maintenance
    Lets any MCP-capable coding harness (Cursor, Claude Code, Codex, Gemini CLI, VS Code/Copilot, opencode, and others) hand a self-contained task to a real, isolated DeepSeek Harness process that works in a chosen workspace with its own context window, model, and toolchain, then returns the final answer. Exposes task submission with time estimates and acceptance criteria, status polling with live progress and process-tree telemetry, graceful cancel and forced kill of whole process trees, and a health probe reporting concurrency, deadlines, and recent jobs.
    MIT