@deepseek-ai/dsh-host-mcp-servers

Readme

# mcp-deliverable

[English](#english) | [中文](#中文)

## 中文

这是一个可直接安装到 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) profile 的社区 Bundle，为 Web Settings → Plugins 增加 MCP 服务器管理页。

Bundle 同时包含：

- Host Remote：读取、原子写入和删除当前 profile 的 MCP 配置，并显示 Loader 与工具注册状态。
- Web 设置页：编辑 stdio 与 Streamable HTTP 服务器，包括参数、环境变量、工作目录、请求头、调用超时、启动失败策略和重连策略。
- 自包含 Typert 描述与浏览器产物：从 GitHub 安装时由 `prepare` 构建，不依赖相邻的 Harness 源码检出目录。
- `cordis.patch.yml`：通过 `dsh.bundle.patch` 自动把插件层加入目标 profile。

动态 `!!js` 和无效配置保持可见、可删除，但不会把原始表达式发送到浏览器。字面量 `env` 与 `headers` 会返回可信 Host 的设置客户端用于编辑；秘密值应继续使用环境变量支持的 `!!js` 表达式。

### 从 GitHub 安装

要求 Node.js `^22.19.0` 或 `>=24.0.0`，并使用支持 `dsh plugin` 的 DeepSeek Harness 版本。

```bash
dsh plugin --profile web add github:zhuyan1085/mcp-deliverable
```

Git 安装会运行本仓库的 `prepare` 构建。pnpm 10 及以上默认拒绝执行依赖的构建脚本，因此第一次安装可能会失败并打印需要授权的确切键。按提示在该 profile 的 `pnpm-workspace.yaml` 中加入：

```yaml
allowBuilds:
  '<pnpm 输出的完整包键>': true
```

然后重新执行安装命令。该授权允许包在安装阶段执行代码，只应授予你信任的源码。生产使用建议锁定提交：

```bash
dsh plugin --profile web add github:zhuyan1085/mcp-deliverable#COMMIT_SHA
```

安装完成后重新启动对应 profile。Bundle 层先于用户自己的 `cordis.patch.yml` 应用，因此用户仍可按 `id: mcp-servers` 覆盖或禁用它。

### 配置

正常通过 `dsh` 启动时无需配置：插件写入当前 profile 的 `cordis.patch.yml`。嵌入式或测试运行可以显式指定绝对路径：

```yaml
- id: mcp-servers
  config:
    patchFile: /absolute/path/to/cordis.patch.yml
```

`patchFile` 由导出的 Schemastery `Config` schema 校验；空配置使用当前启动 profile，不使用硬编码部署路径。

### 本地验证与 tarball

在一份已安装依赖的 DeepSeek Harness 检出目录旁运行：

```bash
DSH_CHECKOUT=/absolute/path/to/deepseek-harness bash scripts/verify.sh
pnpm run build
pnpm pack
```

`scripts/verify.sh` 执行严格 TypeScript 检查与聚焦 Vitest；`pnpm pack` 生成可离线分发的预构建 tarball。

## English

This community-maintained installable Bundle adds MCP server management to DeepSeek Harness Web Settings → Plugins. It ships the Host Remote, Web UI, Typert descriptors, browser bundle, and a `dsh.bundle.patch` layer in one Git-installable package.

Install it with:

```bash
dsh plugin --profile web add github:zhuyan1085/mcp-deliverable
```

Git installs run the self-contained `prepare` build. With pnpm 10+, copy the complete package key reported by the first failed install—including its Git source and commit—into the profile's `pnpm-workspace.yaml`, then repeat the command. Pin a trusted commit for production installs:

```bash
dsh plugin --profile web add github:zhuyan1085/mcp-deliverable#COMMIT_SHA
```

The plugin normally targets the active profile's `cordis.patch.yml`; embedded runs may set an absolute `config.patchFile`. Literal `env` and `headers` values are browser-readable by the trusted-host settings client. Keep secrets in environment-backed `!!js` expressions and never commit credentials.