dsh-mcp-skills

Readme

# dsh-mcp-skills

一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 插件，在网页设置面板中新增两个管理页面：

- **Skills** — 浏览、导入、删除、开关用户自有技能（存放于 `$DSH_HOME/skills`）。
- **MCP** — 管理 MCP 服务器配置（stdio / Streamable HTTP），支持增删改与连接测试。启用的服务器写入当前 profile 的 `cordis.patch.yml`，重启后自动连接，工具注册为 `mcp__<server>__<tool>`。

## 截图

**Skills 页面**

![Skills 页面](images/skills.png)

**MCP 页面**

![MCP 页面](images/mcp.png)

## 安装

要求：已安装带 web profile 的 dsh，且 `PATH` 中有 `pnpm`。

从 npm 安装：

```
dsh plugin --profile web add dsh-mcp-skills
```

从 GitHub 安装：

```sh
dsh plugin --profile web add https://github.com/Lrxc/dsh-manage-hub.git
```

或从本地目录：

```sh
git clone https://github.com/Lrxc/dsh-manage-hub.git
dsh plugin --profile web add file:./dsh-manage-hub
```

重启：

```sh
dsh --profile web
```

## 行为说明

- MCP 服务器保存在 `$DSH_HOME/mcp-servers.yaml`；启用的服务器会被写入当前 profile 的 `cordis.patch.yml`，重启 dsh 后自动连接。插件只增删自己生成的 `mcp-*` 行，不改动该文件的其他内容：注释、锚点与 `!!js` 表达式都会原样保留，写入是原子的，并会保留一份 `.bak` 备份。
- 若 profile 的 `cordis.patch.yml` 存在语法错误，插件会拒绝改写并报错，而不是覆盖它。
- 连接测试 15 秒超时，超时会关闭连接并回收子进程。测试与真实挂载使用同一套环境清洗规则：`*_KEY` / `*_PASSWORD` / `*_SECRET` / `*_TOKEN` 与 `DSH_*` 变量不会传给 MCP 子进程，需要凭据时请在服务器的环境变量里显式配置。
- 技能存放在 `$DSH_HOME/skills`。zip 导入支持单个技能（根目录 `SKILL.md` 或 `<name>/SKILL.md`）或多个技能目录，`template/` 会被跳过，已存在的技能不会被覆盖（导入结果会显示跳过数量）。
- 「测试」按钮使用宿主安装自带的 MCP SDK（列为可选 peer 依赖，不随本包重复安装）。若宿主未提供该 SDK，只有这一个按钮会提示不可用，技能管理与其余 MCP 功能不受影响。

## 卸载

```sh
dsh plugin --profile web remove dsh-mcp-skills
```

如不再需要，删除 profile `cordis.patch.yml` 中生成的 `mcp-*` 行及 `$DSH_HOME/mcp-servers.yaml`。



## 开发

发布到npm

```shell
# 1. 用官方 registry 重新登录（务必带 --registry，否则会登到镜像站）
npm login --registry=https://registry.npmjs.org --auth-type=web
# 2. 确认包名可用
npm view dsh-mcp-skills version
# 3. 检查 tarball（务必含 cordis.patch.yml）
npm pack --dry-run
# 4. 发布（稳定版，不要 prerelease）
npm publish
```



## License

MIT