前言¶
DeepSeek Harness (DSH) 采用了插件化架构,旨在通过扩展组件提升智能体的能力。Model Context Protocol (MCP) 是连接大模型与外部工具生态的标准协议。在 DSH 中引入 MCP 支持,需要解决协议适配、工具注册、上下文管理及安全执行等一系列工程问题。dsh-plugin-mcp 插件正是为了解决这些痛点而生,它提供了从 DSH 到 MCP 生态的完整桥接能力。
插件概述¶
名称:dsh-plugin-mcp
定位:DeepSeek Harness (DSH) 的通用 Model Context Protocol (MCP) 桥接插件。
维护者:menotbobbybrown
许可:MIT License
该插件允许 DSH 直接接入并管理 MCP 服务器,提供与 Claude Code 级别相当的功能特性。
核心能力¶
插件提供了一套完整的工具链与安全机制,主要包含以下特性:
- 通用协议支持:支持 stdio、sse (Server-Sent Events) 和 websocket 三种传输协议。
- 大规模服务器管理:内置 10,000+ 服务器规模引擎,采用 JIT 工作线程激活与 LRU 空闲进程回收机制,在管理大量服务器时保持低内存占用。
- 高性能索引与搜索:提供亚毫秒级的 BM25 倒排索引,支持语义工具搜索与 TF-IDF 相关性评分。
- 智能上下文管理:具备动态 Token 预算分配器,支持分层 Schema 缓存 (L1/L2),并包含防止上下文溢出的保护机制。
- 企业级安全:内置企业安全引擎,支持自动掩码敏感信息、命令注入防护、路径遍历防御,以及基于
allow、ask、deny的细粒度执行权限控制。 - 稳定性保障:提供熔断器与速率限制功能,防止服务异常导致死循环或资源耗尽。
- 运维与审计:支持高分辨率遥测数据(p50, p95, p99)与结构化的安全审计日志。
安装与启用¶
在 DSH 中安装插件需要使用官方 CLI。
dsh plugin --profile web add "github:menotbobbybrown/dsh-plugin-mcp"
安装前请确保环境满足运行要求:Node.js 版本需大于等于 20.0.0。
典型用法¶
插件提供了 dsh-mcp CLI 工具,用于管理 MCP 服务器的安装、列表与测试。
- 浏览官方服务器目录
npx dsh-mcp catalog
- 安装常用服务器
指定安装范围(user 为全局,project 为本地):
npx dsh-mcp install github --scope user
npx dsh-mcp install postgres --scope project
- 查看已配置列表
npx dsh-mcp list
- 添加自定义或远程服务器
npx dsh-mcp add custom_srv --scope user -- npx -y my-mcp-server
npx dsh-mcp add postgres --scope project -- npx -y @modelcontextprotocol/server-postgres postgresql://localhost:5432/mydb
npx dsh-mcp add weather --transport sse -- https://weather-mcp.example.com/sse
- 测试连接
验证特定服务器的可用性与工具发现:
npx dsh-mcp test github
- 卸载服务器
npx dsh-mcp remove github --scope user
适用场景与注意事项¶
该插件适合需要在 DSH 中集成数据库、文件系统、API 服务或其他 MCP 生态工具的开发者。
- 权限与安全:插件以当前 DSH 进程的权限运行,建议在安装和配置前仔细审查服务器源码及许可证。
- 资源占用:尽管引擎支持高并发,但在启用大量服务器时仍需关注内存与 Token 预算。
结语¶
dsh-plugin-mcp 为 DeepSeek Harness 提供了通往 MCP 生态的标准化接口。通过其丰富的管理命令与安全特性,开发者可以高效地构建具备外部工具调用能力的智能体。更多技术细节与源码,可访问 GitHub 仓库 或 社区插件目录。