@wjunhere/dsh-mcp-gateway
DSH 的一个 MCP 代理工具：按需搜索、描述和调用 MCP 工具，而不是将每个服务器的架构都放入上下文中
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:wjunhere/dsh-mcp-gateway#eb3adb480aaecc1701665819ff28d2975768298aMcp Gateway 以 @wjunhere/dsh-mcp-gateway 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DSH 一个 mcp 代理工具：MCP 工具不再全部塞进上下文，模型按需搜索、查看、调用。
MCP 服务器一多，工具定义会吃掉整个上下文窗口。一份 19 个启用服务器的配置实测 542 个工具、schema 总量约 4.1 MB。DSH 默认把每个工具都注册成原生工具，每次请求都带上它们，1M 窗口直接被塞满。
这个插件只向模型注册 1 个 mcp 工具，工具清单放在磁盘缓存里，按需检索、按需连接。
| DSH 默认（逐个注册） | 本插件 | |
|---|---|---|
| 模型每次请求看到的 MCP 定义 | 542 个工具，约 4.1 MB（≈103 万 token） | 1 个工具，2.6 KB（≈660 token） |
| 服务器进程 | 启动时全部连上，常驻 | 用到才连，空闲 10 分钟关闭 |
| 服务器连不上 | 启动变慢，工具直接消失 | 记入缓存状态，不影响其它服务器 |
搜索延迟实测：542 个工具上 27–80 ms。
前提：DSH 0.2.1-rc.2。
用插件管理器安装，按你想要的来源选一个 target：
| 来源 | plugin_manager install_bundle 的 target |
|---|---|
| npm | @wjunhere/dsh-mcp-gateway（当前 0.2.0，可写死版本如 @wjunhere/dsh-mcp-gateway@0.2.0） |
| GitHub | git+https://github.com/wjunhere/dsh-mcp-gateway.git |
| Release tarball | https://github.com/wjunhere/dsh-mcp-gateway/releases/download/v0.2.0/wjunhere-dsh-mcp-gateway-0.2.0.tgz |
| 本地开发 | 克隆后的绝对目录，如 B:\path\to\dsh-mcp-gateway |
本地目录方式需要先装依赖：
git clone https://github.com/wjunhere/dsh-mcp-gateway.git
cd dsh-mcp-gateway
npm install
也可以手动在 %USERPROFILE%\.dsh\profiles\desktop\package.json 里加：
"dependencies": { "@wjunhere/dsh-mcp-gateway": "file:<本仓库目录>" },
"dsh": { "profile": { "bundles": [ "...", "@wjunhere/dsh-mcp-gateway" ] } }
然后在 profile 目录执行 pnpm install。
%USERPROFILE%\.dsh\mcp.json（即 $DSH_HOME/mcp.json），下一节是格式。文件不存在时插件会报错，不会静默跳过。name: '@deepseek-ai/dsh-mcp-client' 的行全部加 disabled: true，否则每个服务器会同时以原生工具和网关两种方式加载。mcp({ action: "reload" }) 即可。清单就是一个通用格式的 JSON，mcpServers 下每个键是服务器名：
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "B:/vibe_program"],
"env": { "SOME_TOKEN": "..." },
"cwd": "B:/vibe_program",
"description": "Local filesystem access",
"searchKeywords": { "*": ["file", "目录"], "read_file": ["读文件"] }
},
"remote-docs": {
"url": "https://example.com/mcp",
"headers": { "Authorization": "Bearer ..." }
}
}
}
| 字段 | 说明 |
|---|---|
command / args / env / cwd | stdio 服务器。env 只接受字符串值 |
url / headers | streamable HTTP 服务器；与 command 二选一 |
disabled | true 时不加载，保留条目方便以后启用 |
lifecycle | 目前只是保留字段，服务器一律懒连接 |
requestTimeoutMs | 单次调用超时，覆盖插件级 toolCallTimeoutMs |
description | 服务器说明，出现在搜索结果里 |
searchKeywords | { "*": [...], "工具名": [...] }，让中文或换一种说法也能搜到工具 |
改完清单调一次 mcp({ action: "reload" })：
mcp 工具；mcp({ action: "status" }) 能看到进度；command/url）时 reload 直接报错，旧清单继续工作，不会把运行中的网关搞挂。缓存放在清单同目录的 .dsh-mcp-gateway-cache.json，按每个服务器的 transport 配置（command/args/env/cwd/url/headers）算哈希。只改 description、searchKeywords 不会触发重新发现；改了启动命令会。
Pi 的 mcp-adapter.json 和这里的格式一样，直接复制到 %USERPROFILE%\.dsh\mcp.json 即可。两个注意点：
%USERPROFILE%\.local\bin，Pi 里用裸命令名的服务器（如 uvx、zotero-mcp）要改成绝对路径。directTools 会被忽略，可以删掉。迁移后 DSH 不再依赖 Pi 的配置；Pi 自己继续用自己那份。
插件配置在 cordis.patch.yml 的 mcp-gateway 行里（安装时由 bundle 自带）：
- id: mcp-gateway
name: '@wjunhere/dsh-mcp-gateway'
config:
# 默认就是 $DSH_HOME/mcp.json，换位置才需要写；~ 会展开到用户目录
# configFile: '~/.dsh/mcp.json'
discoverOnStart: background
discoverConcurrency: 2
idleTimeoutMs: 600000
toolCallTimeoutMs: 60000
maxSearchResults: 12
# includeServers: [picgo-uploader, matlab]
# excludeServers: [rea-wsl]
# 按服务器覆盖：只写想改的字段，其余沿用清单
# servers:
# zotero:
# command: 'C:/Users/you/.local/bin/zotero-mcp.exe'
| 字段 | 默认 | 说明 |
|---|---|---|
configFile | $DSH_HOME/mcp.json | 服务器清单路径，~ 展开到用户目录；可指向 Claude/Cursor/Pi 的配置 |
cacheFile | 清单同目录下 .dsh-mcp-gateway-cache.json | 工具元数据缓存 |
discoverOnStart | background | 启动时后台发现；off 则只按需发现 |
discoverConcurrency | 2 | 同时发现几个服务器 |
connectTimeoutMs | 60000 | 连接/列工具的超时 |
idleTimeoutMs | 600000 | 空闲多久关闭连接 |
toolCallTimeoutMs | 60000 | 单次调用默认超时 |
maxSearchResults | 12 | 搜索默认返回条数 |
includeServers / excludeServers | 空 | 只加载/排除指定服务器（用于临时缩小范围） |
servers | 空 | 按服务器覆盖 disabled、command、args、env、cwd、url、headers、description、requestTimeoutMs |
注意：profile 里同 id 的 patch 会整段替换 bundle 自带的 config，所以写覆盖时把要用的字段一起写全。
mcp({ search: "book download" }) → 搜索，返回名字、简述、参数形状
mcp({ describe: "download_book" }) → 完整描述和 input schema
mcp({ tool: "download_book", args: { ... } }) → 调用
mcp({ connect: "archivum" }) → 发现/刷新一个服务器
mcp({ action: "status" }) → 各服务器状态、工具数、发现时间
mcp({ action: "discover" }) → 发现所有缺元数据的服务器
mcp({ action: "instructions", server: "x" }) → 服务器的使用说明
mcp({ action: "reload" }) → 重新读取服务器清单
同一个工具名出现在多个服务器上时，搜索结果会显示成 server/tool，例如
rea/inspect_android_class（rea 和 rea-wsl 的工具名完全重复）。
list_mcp_resources 等 3 个工具由 dsh-mcp-client 提供，禁用那些行之后它们会消失。mcp，参数里有工具名和 server。danger-full-access 下没影响。describe 超过 20 KB 会截断并把全文写到临时文件；工具结果超过 50 KB / 2000 行同理。directTools 式激活。mcp({ action: "status" })：看每个服务器的状态、工具数、失败原因。%USERPROFILE%\.dsh\.dsh-mcp-gateway-cache.json。删掉它会在下次启动时全量重新发现。mcp server "<name>": connect failed: ...，后面会附上该服务器 stderr 的末尾。%TEMP%\dsh-mcp-gateway-resolved.json，对不上配置时看这个文件。includeServers 缩到常用的几个。见 AGENTS.md。测试：
npm run test:unit # 纯函数、配置合并、缓存、搜索格式（CI 跑这个）
npm test # 配置解析 + 真实工具清单（需要本地服务器）
npm run test:smoke # 连接管理：真实服务器 list/call/空闲关闭
npm run test:integration # 真实 cordis + 真实 dsh-tools 注册表 + 真实 MCP 服务器，含 reload
测试有意不使用 mock：默认读取 $DSH_HOME/mcp.json 并连接 archivum、papergate、picgo-uploader。没有这些本地服务器时测试会失败，这是预期行为；换配置文件用 DSH_MCP_GATEWAY_CONFIG=/path/to/mcp.json。