dsh-mcp-scanner

Readme

# dsh-mcp-scanner

在 DeepSeek Harness 的「设置」页里扫描并管理本地注册的 MCP 服务器及其工具。
Scan & manage locally registered MCP servers and their tools in the DeepSeek Harness settings page.

## 功能

- 在「设置 → MCP 服务器」里列出当前 agent 可见的所有 MCP 服务器与工具；
- 支持添加 / 编辑 / 删除 / 启停 / 重连服务器；
- 传输方式支持 `streamable-http` 与 `stdio`；
- 工具统一以 `mcp__<serverName>__<tool>` 提供给 agent；
- 由 profile 的 `cordis.patch.yml` 挂载的服务器显示为「宿主挂载」，此处只读，避免重复连接。

## 安装

> 需要 DeepSeek Harness 环境；依赖官方公共包 `@deepseek-ai/dsh-mcp-client`。

从市场安装（GitHub 仓库需带 `topic:dsh-plugin`）：

```bash
dsh plugin --profile desktop add fatefgo2050/dsh-mcp-scanner
```

或按 npm 包名：

```bash
dsh plugin --profile desktop add dsh-mcp-scanner
```

或本地路径：

```bash
dsh plugin --profile desktop add file:/absolute/path/to/dsh-mcp-scanner
```

安装后重启 DSH 生效。

## 使用

打开「设置 → MCP 服务器」，点「+ 添加 MCP 服务器」填写：

- `streamable-http`：填 URL（可选 headers，例如 `{"Authorization": "Bearer <token>"}`）。
- `stdio`：填 command + args（可选 env）。

添加后会自动等待连接结果；也可手动点「刷新状态」。

## 配置存储

- 在界面里添加的服务器写入 `$DSH_HOME/mcp-servers.json`，可随时启停 / 编辑 / 删除。
- 通过 profile 的 `cordis.patch.yml` 挂载的服务器显示为「宿主挂载」，此处只读；改配置或移除请编辑该文件。

## 安全

- `/mcp-scanner/api/*` 仅在 loopback（127.0.0.1）开放；当 web 服务器对外暴露时该 API 返回 403。
- `stdio` 服务器会执行任意命令，请只添加可信来源。

## 许可

MIT