前言¶

在 DSH 里做工业数据相关对话时，模型需要能确认当前工作空间、查集合与数据源状态，并按权限调用远程接口。若每次都要自己拼 HTTP 客户端、维护文档与检索逻辑，成本高且容易与 Tier0 侧能力不同步。

@tier0/dsh-mcp 是 FREEZONEX 维护的连接器插件，通过 DSH 官方的 MCP 客户端，把 Harness 连到可访问的 Tier0 Cloud /mcp 端点，并自动发现服务端暴露的工具（含 whoami、docs、search、execute）。下面介绍环境与安装、凭证、典型用法及常见问题。

这是什么¶

• npm 包名：@tier0/dsh-mcp（版本 0.1.0，MIT 许可证）
• 维护者：FREEZONEX
• 分类：模型推理（社区目录归类）
• 一句话：用官方 DSH MCP 客户端连接 Tier0 工作空间，在 DSH 内按当前账号权限查询工业数据、查看数据源状态和管理资源。

插件依赖宿主的 @deepseek-ai/dsh-mcp-client，并向 Cordis 注入 bundle patch；中英文元数据与 Tier0 图标随包分发。

核心功能¶

经连接器连上 Tier0 Cloud MCP 服务后，DSH 可发现并调用至少下列能力（具体范围取决于服务端与账号权限）：

典型对话路径是：先 whoami，再通过自然语言让模型列出可访问集合、检查数据源状态，或由 docs / search 定位接口后用 execute 执行。

环境与要求¶

安装与运行前请核对：

• DSH 0.2.2-rc.1，Node.js 24.9.0 或更新
• 可达的 Tier0 Cloud 实例，且已启用 /mcp 端点
• 在该实例中创建的个人 API Key（决定工作空间与访问权限）

默认 MCP 地址为 Tier0 开发环境 https://dev.tier0.cn/mcp；生产或其他实例需在插件设置中改为完整 HTTPS MCP URL（例如 https://your-tier0.example/mcp），再使用该实例的 Key。

安装与启用¶

在已有 profile 上安装（将 web 换成你的 profile 名）：

dsh plugin --profile web add @tier0/dsh-mcp

安装后需重启 DSH。

插件设置项（资料中明确项）：

• url：完整 HTTPS MCP 端点
• apiKeyEnv：默认 TIER0_API_KEY，从 DSH 进程环境读取
• toolCallTimeoutMs：默认 120000

凭证配置¶

插件在激活时从 DSH 进程环境读取 API Key，只需填写 Key 值本身；在启动 DSH 的终端中设置。

PowerShell 7：

$env:TIER0_API_KEY = Read-Host 'Tier0 personal API key' -MaskInput
dsh --profile web

Bash：

read -rs -p 'Tier0 personal API key: ' TIER0_API_KEY
export TIER0_API_KEY
printf '\n'
dsh --profile web

上述方式仅对当前终端会话有效。更换 Key 后需重启 DSH；轮换与吊销在 Tier0 侧管理。

典型用法¶

1. 让 DSH 调用 mcp__tier0__whoami 并汇报已连接的工作空间。
2. 再尝试例如「列出我能访问的集合」或「检查我的数据源并汇总状态」。

模型可先通过 docs 理解概念，用 search 找当前可用接口，再用 execute 调用；读写范围完全由 Tier0 服务端与当前 API Key 权限决定。

适用场景与注意¶

适合：已在用 DSH 做智能体或对话开发、且组织内有 Tier0 Cloud（或兼容 MCP 端点）的开发者；希望在 Harness 内统一完成「身份确认 → 文档/检索 → 执行」而不是手写集成层。

务必注意：

• 插件以当前 DSH 进程的权限与环境变量运行；安装前建议查看 GitHub 仓库 源码与 MIT 许可证。
• 未设置 TIER0_API_KEY 时无法连接，会提示需完成配置。
• HTTP 401 表示 Key 与所配实例不匹配；403 表示权限不足。
• Node.js 须信任目标端的 TLS 证书；工具错误经官方 MCP 客户端返回 DSH。

DSH 生态强调「一切皆插件」；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

@tier0/dsh-mcp 把 Tier0 工作空间上的 MCP 工具（whoami、docs、search、execute）纳入 DSH 工具发现流程，适合在固定 DSH 版本与 Tier0 实例前提下做工业数据相关的对话式操作。

• 社区目录：https://www.skillhub.cn/plugins/FREEZONEX/Tier0-dsh-mcp
• 源码与 README：https://github.com/FREEZONEX/Tier0-dsh-mcp