dsh-mcp-json

English | 中文

Mount MCP servers in the DeepSeek Harness from the configuration files your agent tools already have. It reads the mcp.json of Claude Code, Kiro, OpenCode, and Codex, merges them, and keeps the running server set in step with the files.

The harness MCP client is deliberately one plugin instance per server and reads no files. This package supplies the configuration discovery it does not do: adding a server becomes editing JSON instead of editing the profile's plugin tree.

Requirements

• A working dsh install (this package is a plugin, not a standalone tool).
• At least one MCP configuration file. Any of the locations below counts — an existing Claude Code or Kiro setup works with no new file and no entry config.

Install

dsh plugin --profile web add github:caopu16/dsh-mcp-json

The package declares its own patch layer, so installing it mounts the loader. Built lib/ is committed so a git-sourced install runs no build script.

Without the dsh command

dsh on PATH comes from an installed @deepseek-ai/dsh. From a harness source checkout, run the CLI from that checkout instead:

cd /path/to/deepseek-harness
pnpm dsh plugin --profile web add github:caopu16/dsh-mcp-json
pnpm dsh --profile web

Developing this plugin

lib/ is committed, so a change to src/ reaches consumers only after it is rebuilt and committed too:

npm install
npm run build
npm test

Where it looks

Layers apply from least to most specific, and a server name present in more than one layer is defined by the last file that named it. User-level files come first, then the project-level ones, so a checkout can redirect one server without restating the rest.

Order	Path	Tool	Dialect
1	~/.claude.json	Claude Code	mcpServers
2	~/.codex/config.toml	Codex	TOML [mcp_servers.*]
3	~/.kiro/settings/mcp.json	Kiro	mcpServers
4	~/.config/opencode/opencode.json[c]	OpenCode	mcp
5	~/.dsh/mcp.json	this harness	mcpServers
6	/.mcp.json	Claude Code	mcpServers
7	/.kiro/settings/mcp.json	Kiro	mcpServers
8	/.opencode/opencode.json[c]	OpenCode	mcp
9	/.codex/config.toml	Codex	TOML
10	/.dsh/mcp.json	this harness	mcpServers

The harness's own document sits at the end of each group, so it can override a borrowed configuration without editing the other tool's file. A missing file is normal and silent; a file that exists but cannot be parsed is reported and skipped, leaving the other layers working.

Relaxed JSON is accepted — // and /* */ comments and trailing commas — because every tool in the table writes it and real files carry it.

Dialects

The three vocabularies describe the same servers with different field names, and this plugin translates them rather than asking you to rewrite anything:

	Claude / Kiro	OpenCode	Codex
Section	mcpServers	mcp	mcp_servers
Format	JSON(C)	JSON(C)	TOML
Command	command + args	command as one argv array	command + args
Environment	env	environment	env
Transport tag	stdio / http	local / remote	stdio / http
Switched off	disabled: true	enabled: false	—

An entry that names no transport is inferred: a url means HTTP, otherwise stdio.

disabled: true (or OpenCode's enabled: false) keeps a server unmounted. autoApprove is recognized and ignored — tool approval belongs to the harness approval capability, which this plugin does not speak for.

Config

Every field is optional, and the defaults need no configuration at all:

To change one, patch the row by id in ~/.dsh/profiles//cordis.patch.yml:

- id: mcp-json
  config:
    borrow: false

That entry targets the existing row by id. Do not wrap it in an insert: list — this package's own patch layer already inserts mcp-json, and a second insert of the same id fails the whole profile at boot with duplicate loader entry id: mcp-json.

Field	Default	Meaning
userPath	~/.dsh/mcp.json	This harness's own user-level document.
cwd	the process working directory	Directory the project-level layers resolve against.
borrow	true	Whether to read the other tools' files. false restricts discovery to userPath and /.dsh/mcp.json.
watch	true	Reload when any layer changes.
debounceMs	150	Quiet period after a file event before re-reading.

Live reload

A changed file is reconciled per server, not by remounting everything: a server whose resolved configuration is unchanged keeps its connection and its registered tools while its neighbours change. Adding an entry mounts one server, removing or disabling one unmounts it, and editing one replaces just that server.

An editor writes a document as several operations, so events are coalesced over debounceMs before the files are re-read.

Tool names

Each server's tools reach the model as mcp____, which is the harness MCP client's own convention. The server name is therefore a namespace, and the client requires it to match [A-Za-z0-9_-]{1,32}. A name outside that set is reported with the file that supplied it and skipped, rather than failing the whole load.

Known Limitations and Deferred Work

• Trae is not supported. No verifiable MCP configuration path was found for it; adding a guessed path would ship a location that never matches.
• Cursor and VS Code are not read. Same reason — their locations were not verified on a real installation.
• Timeouts are not read from the source file. OpenCode's per-server timeout and any other tool-specific tuning are ignored; every server gets the harness client's 60-second tool-call timeout.
• autoApprove has no effect. Tool approval is the approval capability's decision, so a pre-approved list in another tool's file does not carry over.
• A watched file that never existed is only noticed on a full reconcile. Chokidar watches the paths, so creating a previously absent layer does fire, but a path whose parent directory is also absent may not be observed until another layer changes.
• One cwd per plugin instance. The project layers resolve against the configured directory, not per-session working directories.

License

MIT