Skip to main content
Glama
pjzck

dsh

by pjzck
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

dsh-mcp-bridge

把 DeepSeek Harness 暴露成一个 MCP server，让 Codex 或其他 MCP 客户端把任务交给 DSH 执行。

MCP client → dsh-mcp-bridge → dsh --profile sdk → DSH agent → workspace

桥只负责建会话、投任务、等结果；规划、读写文件、跑命令都由 DSH 自己的 agent 完成。它使用 DSH 官方 SDK profile，不修改桌面端，也不是 DSH 插件。

要求

  • DSH Desktop 已安装，且 dsh 命令可用

  • Node.js 22+

  • DEEPSEEK_API_KEY：放在环境变量，或留在 $DSH_HOME/.credentials.yaml（桥会自动读取）

Related MCP server: hermes-dsh-bridge

安装

git clone https://github.com/pjzck/dsh-mcp-bridge.git
cd dsh-mcp-bridge
npm install
npm run test:smoke

接到 Codex

codex mcp add dsh -- node "H:\path\to\dsh-mcp-bridge\src\server.mjs"

或写进 ~/.codex/config.toml：

[mcp_servers.dsh]
command = "node"
args = ["H:\\path\\to\\dsh-mcp-bridge\\src\\server.mjs"]

首次调用 MCP 工具时 Codex 会要求审批，允许即可。非交互的 codex exec 默认拒绝 MCP 工具，自动化场景请加 --approve-for-me。

工具

工具

作用

dsh_info

查看 dsh 命令、模型、API key、运行中的会话

dsh_start

投任务，立即返回 sessionId

dsh_wait

等当前 turn，最多 30 秒，可重复调用

dsh_run

投任务并等到完成，适合短任务

dsh_get

读取当前状态和最后输出

dsh_sessions

列出本进程启动过的会话

dsh_shutdown

停掉 SDK runtime

典型用法：

dsh_info
dsh_start { task: "实现 X 并跑测试", cwd: "H:\\repo" }
dsh_wait  { sessionId: "session-…" }

续聊时把上次的 sessionId 传给 dsh_start。

配置

环境变量

说明

DSH_MCP_DSH_COMMAND

dsh 可执行文件路径；默认用桌面端 dsh.cmd 或 PATH 上的 dsh

DSH_MCP_PROVIDER

模型 provider；默认读 DSH settings

DSH_MCP_MODEL

模型 id；默认读 DSH settings

DEEPSEEK_API_KEY

API key；默认读 $DSH_HOME/.credentials.yaml

DSH_HOME

DSH home，默认 ~/.dsh

DSH_PERMISSION_MODE

DSH 权限模式，默认 workspace-write

DSH_MCP_DEBUG

设为 1 输出 SDK 子进程日志

限制

  • SDK 协议没有 per-turn cancel；只能 dsh_shutdown 停 runtime。

  • 会话在独立的 SDK runtime 里，不会出现在桌面端窗口中。

  • 需要 API key；SDK profile 不使用桌面登录态。

  • 同一个 sessionId 同时只能有一个进行中的 run。

License

MIT

This server cannot be deployed

Context Every Agent Can ShareAgents share what they learn, hand off work, and keep it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • 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.
    62 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.
    373 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

  • dsh-mcp-server

    ipumpkin
    A
    license
    Not graded
    quality
    B
    maintenance
    Exposes DeepSeek Harness agent capabilities over MCP so any MCP client can delegate real coding work to a running agent with its full toolset (bash, filesystem, todo, web). Turns are dispatched asynchronously into sessions and then tracked through status, tail, wait, cancel, compact, and rename tools, with the session log as the source of truth so results survive restarts.
    MIT