DSH MCP Server（dsh-mcp-btwy）

简体中文 · English

一个 DeepSeek Harness（DSH）插件：从正在运行的 Harness 宿主发布一个 Model Context Protocol（MCP）
服务，让别的 agent harness——Claude Code、Cursor、Codex、另一个 DSH、任何 MCP 客户端——可以直接调用
DSH：创建会话、推进回合、等待结果、读取对话记录、取消工作。

插件是仅宿主侧的 bundle，零依赖。每个请求都归因到发起调用的 agent，每个会话都记录在它的创建者名下，
所以多个 harness 可以共用一个端点，仍然能问"哪些会话是我的？"。同一套工具也会注册进本机 Harness，
在那里按调用会话自身的权限收紧。

其他 harness ──MCP（Streamable HTTP 或 stdio）──> DSH MCP Server ──> DSH 服务
                                                                     sessionController / sessionQuery / tools

它能做什么

• 用任意 MCP 客户端驱动 DSH。 dsh_run_prompt 创建会话并返回 sessionId；
  dsh_continue_session 延续它的上下文与工作区；dsh_wait_session 只等待、不取消；
  dsh_cancel_session 停止回合但保留收件箱。Streamable HTTP 与 stdio 桥都可用。
• 长调用不会撞上客户端自己的超时。 超过 10 秒仍在运行的调用改以事件流作答——立刻发出响应头，
  之后每 15 秒一条 : keep-alive 注释，最后是该 JSON-RPC 响应——所以持续数分钟的 dsh_wait_session
  不会被客户端 300 秒的响应头上限掐断。
• 读得准，而不是整份倒出来。 dsh_list_sessions 分页列出会话索引，dsh_search_sessions
  只返回有限的片段，dsh_read_session 以 tail/head/outline 窗口读取，带游标、单条上限和整包预算；
  每个结果都会说明它没有返回什么。
• 多个 harness 共用一个端点。 调用方身份按请求头、clientInfo 或 User-Agent 解析；会话记录在
  所有者名下；restrictToOwner 把每个调用方限制在它自己创建的会话里。
• 看见模型看不见的决策。 dsh_list_requests 报告审批请求和未回答的用户提问（含工具、原因、
  call id）；开启 answerApprovals / answerQuestions（旧的 answerUserRequests 仍作总开关）后，
  dsh_answer_request 可以和 GUI 竞速地给出决定。
• 问一个目标必须回答的问题。 dsh_ask_session 让提问回合一直阻塞到被问会话回答；问题带编号，
  提醒只搭在目标自己的调用上（绝不唤醒会话），人为停止会直接结案且不打扰任何人。
• 内部消息说清楚是谁发的。 别的会话送进来的消息（本插件投递的提示词、进度同步的通知与报告，以及
  Harness 自己的智能体/团队转投）在气泡上方有一行来源：「来自「<会话标题>」· MCP 消息」，点一下就打开
  那个会话。本插件投递的消息本身就是气泡，不是“收到执行请求”那种唤醒卡片；超过 12 行或 700 字的投递
  自动折叠成固定高度，底部给出「展开全部（N 行）」；人自己打的消息没有这一行。
• 避免同工作区的 agent 撞车。 任务开始时进度同步会询问同一工作区里的其他顶层 agent 正在做什么、
  在改哪些文件；它作为独立的 dsh-work-sync 行挂载。
• 在 DSH 内部调用同一套工具。 默认的 lazy 工具面是一个三工具前门（dsh_mcp_tools、
  dsh_mcp_open、dsh_mcp_call），常驻约 820 token 而不是 6.3k；full 则注册全部 26 个。
  内部调用始终被限制在调用者自己的沙箱与工作区内。
• 把人带到现场。 端点创建的会话会归入其目录已有的侧边栏项目；dsh_open_session 让打开的
  Web GUI 直接选中某个会话。
• 在插件页配置，或用预设一次设好。 开关、lazy/full 工具面、侧边栏分组、忙碌时投递方式、进度同步，
  都是插件包自己页面上的控件，经配置文件编辑器保存；「内部消息的呈现」可在气泡与
  提醒卡片之间切换；部署级还可以在行里写
  preset: delegate | strict | observer，只填充没显式设置过的字段。

快速开始

1. 安装到 DSH 配置档案（npm 包 dsh-mcp-btwy，零依赖）：

   # 在 Plugins 页面点 Add plugin，把包名粘进输入框：
   dsh-mcp-btwy
   # 或者命令行（profile 名以你的安装为准，桌面版是 desktop）：
   dsh plugin --profile desktop add dsh-mcp-btwy
   

   从源码安装（开发或离线）同样可行：git clone 后在 Add plugin 里粘仓库路径，或
   plugin_manager install_bundle --target /path/to/dsh-mcp-server。

2. 读取插件发布的连接信息（文件权限 0600）：

   $DSH_HOME/mcp/dsh-mcp-endpoint.json    # { url, token, stdioBridge, tools }
   

3. 让客户端连上端点（下图为 Streamable HTTP；stdio、其他客户端见
   快速开始文档）：

   {
     "mcpServers": {
       "dsh": {
         "type": "http",
         "url": "http://127.0.0.1:19387/mcp",
         "headers": { "Authorization": "Bearer <dsh-mcp-endpoint.json 里的 token>" }
       }
     }
   }
   

4. 调用它。 先创建会话，再继续：

   dsh_run_prompt({ "prompt": "summarize README.md", "cwd": "/path/to/repo" })
   // → { "sessionId": "session-…", "text": "…" }
   
   dsh_continue_session({ "sessionId": "session-…", "prompt": "now list the TODOs" })
   

安全边界

这个插件的用途是让另一个 harness 操作本机这台 DSH，所以边界是设计的一部分，不是可选项：

• 端点默认只绑回环地址（127.0.0.1）；要对外暴露得显式改 host，而这通常不该做。
• 每个请求都要 Bearer token；token 写在 $DSH_HOME/mcp/dsh-mcp-endpoint.json（权限 0600），
  不接受 URL 查询串（那会进代理日志）。
• restrictToOwner 把每个调用方限制在它自己创建的会话里；跨会话来宾调用被拒绝。
• 代答审批（answerApprovals）等于把沙箱提权的同意权交出去；不确定时保持关闭。

安装前请确认你信任会调用这个端点的 harness——它在你的用户权限下运行。

文档

两种语言的完整索引见 文档目录。

状态

版本 1.0.5，已针对 DSH 0.2.2-rc.1（Cordis 4.1.0）验证：26 个 MCP 工具、2 个资源、
1 个资源模板、291 项离线检查，外加在线 HTTP 与 stdio 套件。仅宿主侧、零依赖、MIT。
DSH 自带 MCP 客户端（0.2.1 起，已在 0.2.2-rc.1 上复验），所以除了本插件的内建前门，也能让 Harness 直接连接本端点——见
用 DSH 自己的 MCP 客户端连进来。
从 1.0.0 起，工具名、资源 URI、配置字段与 MCP 协议面按语义化版本对待：破坏其中任何一项都需要大版本。
插件不 import 任何 DSH 包，所以兼容性取决于服务契约而不是版本锁定——见
内部实现。逐版本变更见 CHANGELOG.md。

许可证

MIT