dsh-mcp-settings

Readme

# dsh-mcp-settings

在 DSH 设置中新增 **[MCP]** 页面:可视化各配置来源中的 MCP 服务器,并支持新增 MCP 服务器。

## 功能

- **MCP 服务器列表**:展示组合中生效的 MCP 服务器(serverName、传输方式、命令/URL、参数、环境变量与请求头、调用超时、启停状态)
- **配置来源**:全局级(profile 用户层 `~/.dsh/profiles/<name>/cordis.patch.yml`)中声明的 MCP 行及行号
- **新增 MCP 服务器**:表单生成配置片段;可写入时保存到配置文件(自动热生效),否则复制生成的 YAML 并打开配置文件
- **安全**:环境变量与请求头只显示键名,不显示值
- **主题适配**:UI 使用 DSH 主题变量,自动跟随明暗主题

## 安装

1. 从 [GitHub Releases](https://github.com/xluomo/dsh-mcp-settings/releases) 下载最新 tarball:

   ```sh
   curl -LO https://github.com/xluomo/dsh-mcp-settings/releases/download/v0.1.2/dsh-mcp-settings-0.1.2.tgz
   ```

2. 安装到 profile:

   ```sh
   dsh plugin --profile web add ./dsh-mcp-settings-0.1.2.tgz
   ```

3. 重启 `dsh web`。设置 → 侧边栏出现 **MCP**。

运行时依赖(`@deepseek-ai/*`、`react`)由 DSH profile 提供,无需额外安装。

## 卸载

1. 从 profile 移除插件:

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

2. 重启 `dsh web`。设置 → 侧边栏中的 **MCP** 页面即消失。

## 构建

```sh
pnpm install
pnpm build   # 产出 lib/index.js 与 lib/client.js
pnpm pack    # 产出 dsh-mcp-settings-0.1.2.tgz
```

将 tarball 作为 GitHub Releases 资产发布。

## 限制

- 配置来源仅解析全局级(profile 用户层);`--patch` overlay、home 用户层与 agent preset 中的 MCP 不在范围内
- 环境变量与请求头仅显示键名,不显示值