Skip to main content
Glama
Sign In
dsh-cli-mcp

dsh-cli-mcp

by minmax
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

dsh-cli-mcp

status

MCP server that delegates coding tasks to your locally installed DeepSeek Harness CLI (dsh, npm package @deepseek-ai/dsh).

It wraps the real dsh binary instead of bundling its own copy of the agent, so every call inherits your DeepSeek login, models and config.

This is a minimal first scaffold. The wrapped CLI is invoked one-shot via dsh --print "<prompt>". Sessions, ACP transport, mid-run control, and the dsh web UI integration are out of scope for v0.1.0 and will land in later releases.

Sibling of mcode-mcp, qwen-cli-mcp, kimi-cli-mcp, pi-cli-mcp and grok-code-mcp — same architecture, same principles, DeepSeek Harness behind the wheel.

Install

npx -y dsh-cli-mcp         # no install
npm install -g dsh-cli-mcp # or global

Requires Node >= 22 and a working dsh on PATH (npm i -g @deepseek-ai/dsh or pnpm add -g @deepseek-ai/dsh).

To point the adapter at a non-PATH binary without changing global PATH:

export DSH_MCP_BIN=/path/to/dsh

Related MCP server: chat2dsh

Use with Claude Code / Cursor

claude mcp add-json dsh -s user '{
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "dsh-cli-mcp"],
  "timeout": 3600000
}'

Any other MCP client:

{
  "mcpServers": {
    "dsh": { "command": "npx", "args": ["-y", "dsh-cli-mcp"] }
  }
}

Keep the server name short (dsh): it becomes part of the tool names your model sees.

Available tools

Tool

Purpose

dsh

Run a prompt through DeepSeek Harness. Returns the final answer plus the exit code, wall time, and the last 4 KB of stderr.

dsh

Argument

Notes

prompt

Required. The task for the DeepSeek Harness agent. Self-contained — dsh cannot see your conversation.

cwd

Optional absolute path. Defaults to the server's cwd.

timeout_ms

Optional integer, default 300 000 (5 min), max 1 800 000 (30 min). Wall-clock cap on the run.

dsh({
  prompt: "Reply with exactly: hello from dsh",
  cwd: "/abs/path/to/repo",
  timeout_ms: 120000,
})

The server spawns dsh --print "<prompt>" as a child process, waits for it to finish, and returns one text block containing the prompt echo, the trimmed stdout, the tail of stderr, the exit code, and the elapsed wall-clock time.

A non-zero exit code is reported as a tool error (isError: true) — the adapter does not invent success where dsh itself returned failure.

Development

git clone https://github.com/minmax/dsh-cli-mcp.git
cd dsh-cli-mcp
pnpm install
pnpm run build
pnpm run lint
pnpm test

pnpm run test:live exercises the real dsh binary end-to-end (DSH_CLI_MCP_LIVE=1 opt-in). The default unit suite runs without dsh and exercises the adapter's stdio JSON-RPC loop directly.

License

MIT. See LICENSE.

Available Tools

1 tool
dshA
Destructive

Run a prompt through your locally installed DeepSeek Harness CLI (dsh --print). Blocks until dsh settles, then returns the captured stdout, the last 4 KB of stderr, the exit code, and the wall-clock time. dsh cannot see this conversation, so the prompt must be self-contained: file paths, goal, constraints, expected output format.

Inputs: prompt (required), cwd, timeout_ms.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    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

    TDQS

    A4.2/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no possibility of confusion or overlap. The tool's purpose is clear and distinct by definition.

    Naming Consistency5/5

    With a single tool named 'dsh', the name is concise and directly tied to the underlying CLI. While there is no pattern to evaluate, the naming is consistent with the server's purpose and poses no ambiguity.

    Tool Count3/5

    A single tool is thin for most MCP servers, but here it serves a narrow, specific purpose (running a single CLI command). It feels borderline—appropriate for a minimal wrapper but could benefit from additional tools for managing or inspecting dsh state.

    Completeness4/5

    For its stated purpose of executing a prompt through dsh, the tool covers the essential functionality. Minor gaps exist, such as lacking support for listing available prompts or managing dsh configuration, but agents can work around these by crafting self-contained prompts.

    Resources

    Related MCP Connectors

    Related MCP Servers

    • dsh-codex-bridge

      bwndlct
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables Codex to hand off coding tasks to a locally running DeepSeek Harness Desktop Host over MCP, reusing the Host's configured model and runtime and returning a session ID for status checks, incremental event streaming, waiting, and cancellation.
      MIT

    • chat2dsh

      lvoliverrrr
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables any MCP client to hand self-contained coding tasks to a local DeepSeek Harness instance, which executes them by reading and editing files and running commands within whitelisted directories. Exposes a health check and a blocking task-runner over stdio or authenticated HTTP, returning stdout, stderr, exit code, and duration.
      MIT

    • harness-relay-mcp

      ksoulness
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables Codex to delegate scoped tasks to a local DeepSeek Harness over MCP — dispatching read-only reviews or authorized workspace writes, steering and monitoring runs to a terminal state, and returning structured evidence such as changed paths, test results, and assistant text. It also supports exact archival of the terminal session by full session ID.
      1
      MIT