MCP 连接管理anht3889/dsh-mcp-management

dsh-mcp-management

面向 DeepSeek Harness 的树外 MCP 连接管理。
架构与范围见 docs/design.md。

安装

从 npm 安装（在包发布之后）：

npx @deepseek-ai/dsh plugin --profile web add @anht3889/dsh-mcp-mgmt-bundle@0.0.6

从本地检出安装（开发时），并在本仓库旁放置一个 deepseek-harness 检出——tsc 会从那里解析 harness 项目引用：

pnpm install && pnpm run build
npx @deepseek-ai/dsh plugin --profile web add ./packages/bundle

安装后重启 Web profile。

不要为同一个 serverName 再挂载 @deepseek-ai/dsh-mcp-client——两者都会注册 MCP 工具，会产生冲突。

设置界面

添加服务器。 打开 Settings → MCP Servers，选择 Add server。填写名称、传输方式（stdio 或 HTTP）、命令或 URL，以及认证信息，然后点击 Save。超时与重连选项位于 Advanced settings 下。

添加 MCP 服务器

服务器列表。 每一行显示服务器名称、Enabled 开关，以及传输方式、连接状态和已启用工具数量的摘要。Authorize 仅在 OAuth 服务器尚无令牌时出现。点击该行可打开详情。

MCP Servers 列表

服务器详情。 可切换服务器或单个工具，Reload 以重新连接并重新列出工具，打开 Connection logs，或使用 Edit configuration、Log out 和 Delete。禁用某个工具会将其注销而不断开连接；该选择存储在服务器记录中，重启后仍然保留。

MCP 服务器详情

存储

| 数据 | 默认路径 |
|---|---|
| 非机密服务器记录，包括已禁用的工具名称 | ~/.dsh/mcp/servers.json |
| 机密信息（令牌、请求头值、客户端密钥） | ~/.dsh/mcp/secrets.yaml，或在挂载时使用 ctx.credentials |

可通过 manager 插件的 catalogPath / secretsPath 配置进行覆盖。

位于私有证书颁发机构之后的服务器

Node 仅信任其自带的证书颁发机构，因此当 HTTP 服务器的证书来自企业 CA 时，即使浏览器或 curl 能访问，也会因 self-signed certificate in certificate chain 而连接失败。在 manager 插件上设置 trustSystemCertificates: true 以同时信任主机的证书颁发机构，或以 NODE_OPTIONS=--use-system-ca 启动主机。两者都会为整个主机进程放宽 TLS 信任，这也是该配置默认关闭的原因。

OAuth
每个服务器的回调 URL 是实时 Web 源加上该服务器的 auth.redirectPath（默认为 /callback）。当浏览器通过不同的源访问主机时，请在管理器上设置 publicOrigin。授权服务器会精确匹配重定向 URI；预先注册的公共客户端通常允许在任何回环端口上使用 /callback。管理器会提供所有已配置的路径。授权请求和令牌请求还会将 MCP URL 作为 RFC 8707 resource 指示符发送。

包

| 包 | 作用 |
|---|---|
| @anht3889/dsh-mcp-mgmt-bundle | 可安装界面：补丁、管理器、设置 UI |
| @anht3889/dsh-mcp-mgmt-mcp | ctx.mcp 词汇表（库） |
| @anht3889/dsh-mcp-mgmt-oauth | PKCE OAuth + 发现（库） |

许可证

MIT