dsh-mcp-adapter
DeepSeek Harness 的 MCP 适配器——使用一个代理工具，而不是将每个 MCP schema 都倾倒到上下文中。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-mcp-adapter@0.6.3Mcp Adapter 以 dsh-mcp-adapter 发布，当前版本为 0.6.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Use MCP servers with DeepSeek Harness without burning the context window.
One mcp proxy tool. Lazy server start. On-demand search / describe / call. Configure from the Web /mcp menu.
English | 中文
DeepSeek Harness already ships @deepseek-ai/dsh-mcp-client. That client connects at startup and registers every advertised MCP tool as a native mcp__<server>__<tool> function. Schema cost is paid on every request.
This adapter follows the pi-mcp-adapter contract instead:
mcp proxy tool instead of hundreds of schemassearch / describe / call.mcp.json discovery, plus a Web /mcp menu that can write the project filedirectTools promotion for hot-path toolsIt is an independent plugin. It is not affiliated with DeepSeek AI.
Do not mount this adapter and @deepseek-ai/dsh-mcp-client against the same servers. They would double-connect and fight over names.
dsh plugin --profile web add dsh-mcp-adapter
Restart dsh web and hard-refresh the browser. The package is dual-face: the Host half registers tools and commands; the Web client half adds the /mcp popup and MCP tool cards.
There is no MCP form under Settings → Plugins. Official plugin settings are an allowlist; out-of-tree plugins cannot register a card there. Configuration happens in the /mcp menu or in JSON files.
In Chat, type /mcp:
| Menu | What it does |
|---|---|
| Status / Sources / Prompts | Inspect state |
| DeepWiki, Context7, Notion, GitHub, Chrome DevTools | One-click add to project .mcp.json |
| server · Connect / Authorize | Connect, or open the OAuth browser flow |
| server · Disable / Remove | Confirm, then stop or delete |
Custom server (also writes .mcp.json and reloads in-process):
/mcp add docs url=https://mcp.example.com/mcp
/mcp add fs command=npx args=-y,@modelcontextprotocol/server-filesystem,/tmp
Then ask the model to mcp({ search: "screenshot" }). Tool cards use the same DisclosureRow / StateDot / SearchBlock chrome as first-party Skill and Tool rows. approveTools uses the Chat Ask dialog.
Preferred project file is still .mcp.json if you want the same servers in Cursor or other hosts:
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["-y", "chrome-devtools-mcp@1.6.0"]
}
}
}
| File | Purpose |
|---|---|
~/.config/mcp/mcp.json | User-global shared MCP config |
~/.agents/mcp.json | User-global tool-agnostic MCP config |
~/.agents/mcp/mcp.json | User-global tool-agnostic MCP config |
.mcp.json | Project-local shared MCP config (Web add/remove writes here) |
$DSH_HOME/mcp.json | dsh global override (~/.dsh/mcp.json by default) |
.dsh/mcp.json | dsh project override |
Later files win. /mcp disable and /mcp enable write only the disabled field to .dsh/mcp.json. They never copy credentials.
Host-specific configs (Cursor, Claude Code, Codex, OpenCode, Windsurf, VS Code) are detected by dsh-mcp-adapter init and /mcp list. They are not loaded unless you set settings.hostConfigDiscovery to "on" or list them in imports.
{
"imports": ["cursor"],
"settings": {
"hostConfigDiscovery": "off",
"toolPrefix": "server",
"idleTimeout": 10
},
"mcpServers": {}
}
{
"mcpServers": {
"my-server": {
"command": "npx",
"args": ["-y", "some-mcp-server"],
"lifecycle": "lazy",
"idleTimeout": 10,
"requestTimeoutMs": 30000,
"directTools": ["search"],
"includeTools": ["search", "get_*"],
"excludeTools": ["admin_*"],
"searchKeywords": {
"search": ["find", "lookup"]
}
}
}
}
| Field | Meaning |
|---|---|
lifecycle | lazy (default), eager, keep-alive, lazy-keep-alive |
idleTimeout | Minutes before an idle lazy server is closed (default 10, 0 disables) |
directTools | true or a name list — register those tools as native dsh tools |
url / headers / bearerToken / bearerTokenEnv | Streamable HTTP; SSE fallback on 404/405 |
auth / oauth | "oauth" or "bearer"; OAuth tokens go in the OS credential store |
socket | rmcp-mux Unix-domain socket (mutually exclusive with command / url) |
approveTools | true or globs — Chat Ask before those tools run |
disabled | Keep the entry visible but do not connect |
mcp({ search: "screenshot" })
mcp({ describe: "chrome-devtools_take_screenshot" })
mcp({ tool: "chrome-devtools_take_screenshot", args: { format: "png" } })
mcp({ connect: "chrome-devtools" })
mcp({ action: "auth-start", server: "notion" })
mcp({ action: "auth-complete", server: "notion", args: { redirectUrl: "http://localhost:.../callback?code=..." } })
mcp({ prompt: "create_plan", server: "agent-board", args: "harden retry policy" })
args can be a JSON object or a JSON string. mcpScript can loop / search / call several MCP tools in one JavaScript request.
/mcp
/mcp status
/mcp list
/mcp json
/mcp setup
/mcp prompts
/mcp add-preset <deepwiki|context7|notion|github|chrome-devtools>
/mcp add <name> url=<url>
/mcp add <name> command=<cmd> [args=a,b] [auth=oauth]
/mcp connect <server>
/mcp auth <server>
/mcp enable <server>
/mcp disable <server>
/mcp remove <server>
dsh-mcp-adapter init
dsh-mcp-adapter status
| Piece | 0.6.3 |
|---|---|
mcp proxy + lazy lifecycle + metadata cache | yes |
Web /mcp configure / connect / auth | yes |
Web cards (DisclosureRow / SearchBlock) | yes |
Web Ask for approveTools | yes |
OAuth, prompts, mcpScript, Agent Plugins, sockets | yes |
| Settings → Plugins form | no (host allowlist) |
| elicitation / sampling / MCP UI apps | not in dsh host yet |
Inspired by pi-mcp-adapter (MIT). See NOTICE.
给 DeepSeek Harness 用的 MCP 适配器：一个代理工具，按需搜索 / 描述 / 调用，不把每个 MCP schema 塞进上下文。
配置入口是 Web 的 /mcp，不是 Settings。 官方插件设置页不允许外部插件挂表单。
dsh plugin --profile web add dsh-mcp-adapter
重启 dsh web，硬刷新，在输入框敲 /mcp：
.mcp.json，立刻生效）/mcp add docs url=https://… 或 /mcp add fs command=npx args=-y,pkg然后让模型 mcp({ search: "screenshot" })。卡片和官方 Skill / Tool 行同一套 DisclosureRow / StateDot / SearchBlock。
也可以继续用手写 .mcp.json / ~/.config/mcp/mcp.json，和其他 MCP 宿主共用。不要和 @deepseek-ai/dsh-mcp-client 挂同一批 server。