Skip to content
Back to search

dlqq-mcp-server-dsh-client

dlqq-mcp-client(会话感知 MCP 客户端 · DSH 插件)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/donglouqiaoque--dlqq-mcp-server-dsh-client/badge.svg)](/listings/donglouqiaoque--dlqq-mcp-server-dsh-client)

HTML

<a href="/listings/donglouqiaoque--dlqq-mcp-server-dsh-client"><img src="/api/listings/donglouqiaoque--dlqq-mcp-server-dsh-client/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 110 lines
  1. # dlqq-mcp-client(会话感知 MCP 客户端 · DSH 插件)
  2. DeepSeek Harness(DSH)Host 插件:把 MCP 服务器接入 DSH,并在每次 `tools/call`
  3. 时带上调用方的会话 ID(`params._meta[<sessionMetaKey>]`),使**单个 MCP 服务进程
  4. 可以按对话隔离工作区**。
  5. > 英文版:[README.en.md](README.en.md)
  6. ## 解决的痛点
  7. 官方 `@deepseek-ai/dsh-mcp-client` 每个插件条目只建一条连接,请求里也不带会话信息,
  8. 于是所有对话共用一个 MCP 实例、一个全局工作区。本插件与官方行为一致,只增加
  9. `_meta` 注入这一步,服务端据此区分会话。
  10. ## 实现方式
  11. 以官方 `@deepseek-ai/dsh-mcp-client`(MIT)源码为基础 fork,只改三处:
  12. | 文件 | 改动 |
  13. |---|---|
  14. | `lib/official/tools.ts` | 新增 `sessionMetaOf()`;`callTool` 参数加入 `_meta`(会话键 + Agent 键) |
  15. | `lib/official/connection.ts` | 把 `config.sessionMetaKey` / `config.agentMetaKey` 传入工具桥接 |
  16. | `lib/official/index.ts` | 配置增加 `sessionMetaKey`(默认 `dsh/sessionId`)与 `agentMetaKey`(默认 `dsh/agentId`) |
  17. 其余(连接、重连、诊断、凭据清洗、工具注册、结果投影)与官方完全一致。
  18. ## 当前状态
  19. | 项 | 状态 |
  20. |---|---|
  21. | 插件实现 | ✅ 已完成(Host 侧,尚未安装实测) |
  22. | 构建产物 | ✅ `dist/plugin.js`(46.7 KB) |
  23. | Java 服务端会话隔离 | ❌ 尚未实现(另一仓库 `dlqq-mcp-server-java-server`) |
  24. > 服务端未实现前,插件能正常注入 `_meta`,但服务端会忽略它(行为等同官方客户端)。
  25. ## 目录结构
  26. ```
  27. index.js # 入口:re-export dist/plugin.js
  28. dist/plugin.js # 构建产物(由 npm run build 生成,需提交)
  29. lib/official/*.ts # 官方源码 fork(13 个文件 + LICENSE)
  30. cordis.patch.yml # 插入 DSH 组合的插件行
  31. locale/ # 插件列表显示文案(zh / en)
  32. docs/DETAIL.md # 插件详情页
  33. icon.png # 插件图标
  34. ```
  35. ## 构建
  36. ```cmd
  37. npm install
  38. npm run build
  39. ```
  40. 产物 `dist/plugin.js` 需要一并提交(本地目录/Git 安装都直接使用它)。
  41. ## 安装与启用
  42. 1. **安装**:DSH 中 **Plugins > Add plugin** 选择本目录绝对路径(或 `plugin_manager`
  43. 的 `install_bundle`,`target` 为本目录);
  44. 2. **配置**:打开 **Plugins > dlqq-mcp-client > 配置**,填入自己的 `command` / `args`
  45. (指向本机 `java` 与 `dlqq_mcp_server.jar`),必要时修改 `serverName`;
  46. 3. **启用**:插件包默认 `disabled: true`(不写死任何部署路径),配置完成后打开启用开关;
  47. 4. **重启 DSH** 使插件生效。
  48. `cordis.patch.yml` 只提供占位符,**不需要也不应该在仓库里改成本机路径**;DSH 会把界面里
  49. 填写的配置保存到你的 profile。
  50. `command` 可以直接写 `java`(要求 PATH 上有 Java 25+),也可以用绝对路径指向随包 JDK:
  51. ```yaml
  52. # 写法一:PATH 上的 java
  53. command: 'java'
  54. args: ['-Dfile.encoding=UTF-8', '-jar', 'dlqq_mcp_server.jar']
  55. cwd: '<jar 所在目录>'
  56. # 写法二:随包 JDK 绝对路径
  57. command: '<deploy-dir>/java/bin/java.exe'
  58. args: ['-Dfile.encoding=UTF-8', '-jar', '<deploy-dir>/dlqq_mcp_server.jar']
  59. ```
  60. ## 配置
  61. | 字段 | 必填 | 默认 | 说明 |
  62. |---|---|---|---|
  63. | `serverName` | 是 | — | 客户端标识,同时作为工具名前缀 |
  64. | `transport` | 否 | `stdio` | `stdio` / `streamable-http` |
  65. | `command` `args` | stdio | — | 启动 MCP 服务的命令 |
  66. | `env` `cwd` | 否 | `{}` / 继承 | stdio 环境与工作目录 |
  67. | `url` `headers` | http | — | MCP 端点与附加请求头 |
  68. | `toolCallTimeoutMs` | 否 | `60000` | 单次工具调用超时 |
  69. | `startupTimeoutMs` | 否 | `30000` | 启动与 initialize 超时 |
  70. | `closeTimeoutMs` | 否 | `5000` | 关闭传输超时 |
  71. | `sessionMetaKey` | 否 | `dsh/sessionId` | 会话 ID 的 `_meta` 键名;置空则不发送 |
  72. | `agentMetaKey` | 否 | `dsh/agentId` | Agent ID 的 `_meta` 键名;置空则不发送 |
  73. | `maxInstructionBytes` | 否 | `32768` | 服务器指令最大字节数 |
  74. | `reconnect` | 否 | 启用 | 重连策略(`enabled`/`initialDelayMs`/`maxDelayMs`/`maxAttempts`) |
  75. ## 与服务端的约定
  76. - `_meta` 键名两端必须一致(默认 `dsh/sessionId` 与 `dsh/agentId`);
  77. - 服务端按「会话 × Agent」维护工作区;两个键都不提供时回退到进程级默认会话
  78. (兼容不支持多会话的客户端);
  79. - 会话绑定完全由 `_meta` 驱动,无需额外初始化调用。
  80. ## 许可证
  81. MIT,见 [LICENSE](LICENSE)。`lib/official/` 来自官方 `@deepseek-ai/dsh-mcp-client`
  82. (MIT,Copyright (c) 2026 DeepSeek),原样保留其版权与许可声明。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.