前言¶
DeepSeek Harness(DSH)采用插件化架构,旨在通过配置文件扩展功能。如果需要接入 BaizhiCloud 的 Agent Toolkit,这个社区配置包提供了一种方式:它复用 DSH 现有的 MCP 客户端,通过 Streamable HTTP 端点连接服务,无需额外开发传输层或后端实现。
这是什么¶
这是一个可选的社区配置包,用于将 BaizhiCloud Agent Toolkit 作为 MCP 服务集成到 DSH 中。它由用户 ct-jaryn 维护,遵循 MIT 许可证。该插件不包含任何传输层、后端实现、凭证存储或默认模型提供者,仅负责建立连接和工具发现。
核心功能¶
根据已核实的特性,该配置包主要提供以下能力:
- 复用现有客户端:直接加载 DSH 自带的 MCP 客户端。
- HTTP 连接:连接到 BaizhiCloud 的 Streamable HTTP 端点。
- 认证方式:使用 API Key 作为 Bearer 头部进行静态认证,不使用 OAuth。
- 动态发现:自动发现服务的工具目录。
- 命名空间隔离:将远程工具命名为
mcp__baizhi__<remote-tool-name>,避免命名冲突。 - 无冗余组件:不添加新的传输、后端逻辑或默认模型配置。
安装与启用¶
安装过程需要从本地目录操作。假设你已经下载了该配置包的压缩文件。
- 在配置包目录下打包:
npm pack --ignore-scripts
- 使用 DSH 命令将该包添加到指定配置文件(Profile)中。请将
web替换为你实际使用的 Profile 名称,并将路径替换为实际的文件路径:
npx @deepseek-ai/dsh@0.1.5-rc.2 plugin --profile web add /absolute/path/to/dsh-plugin-baizhi-agent-toolkit-0.1.0.tgz --ignore-scripts
- 配置环境变量。使用你常规的环境变量或密钥管理机制提供
BAIZHI_API_KEY。缺失、空值或仅包含空格的值会禁用该插件条目。设置完成后重启选定的 Profile。
典型用法¶
安装成功后,DSH 会在 MCP 注册表中列出 BaizhiCloud 的工具。
- 确保你的 Profile 进程拥有
BAIZHI_API_KEY环境变量。 - 在 DSH 中执行工具调用时,工具名称格式为
mcp__baizhi__<remote-tool-name>。 - 示例任务:连接成功后,你可以尝试执行以下任务:查找官方的 Model Context Protocol 传输文档,阅读相关页面,并用源链接进行总结。如果工具返回了有用的内容且链接支持总结,说明连接正常。
注意事项与约束¶
在使用前,请注意以下事实和限制:
- 版本依赖:必须使用 DeepSeek Harness 0.1.5-rc.2,且 pnpm 必须在系统 PATH 中。MCP 依赖被锁定在测试版本,与 0.1.6 alpha 或更高版本未建立兼容性。
- 计费与权限:调用 BaizhiCloud 的工具可能会产生费用。服务访问和工具可用性取决于你的账户权限。该插件使用静态 API Key 认证。
- 社区性质:这是一个独立的社区集成,非 DeepSeek 官方应用。公开集成项目和配置包均未将托管后端开源。
- 测试范围:现有的测试使用的是回环 HTTP 模拟器和合成凭证,不包含对真实账户、生产计费、所有操作系统或更新 DSH 版本的测试。
- 移除插件:如需移除,使用以下命令:
npx @deepseek-ai/dsh@0.1.5-rc.2 plugin --profile web remove dsh-plugin-baizhi-agent-toolkit
总结¶
该配置包是一个轻量级的社区集成方案,专注于连接 BaizhiCloud Agent Toolkit。它依赖环境变量进行认证,适合希望在 DSH 生态中复用现有 MCP 客户端的开发者。更多细节和源码,请参考:GitHub 仓库 或 技能中心目录页。