dsh-mcp-manager

English | 简体中文

DeepSeek Harness (DSH) 的 MCP 服务器管理插件 —— 在 设置 → MCP 页签里添加 MCP 服务器（远程 HTTP 或本地 stdio 进程），HTTP 服务器可在 浏览器里完成 OAuth 登录，连接后服务器的全部工具即注册为所有会话可用的原生 mcp____* 工具。

内置的 @deepseek-ai/dsh-mcp-client 只接受静态 headers 配置——不支持 OAuth，也不支持本地 stdio 进程。本插件补上这块：

• OAuth（授权码 + PKCE）：RFC 7591 动态客户端注册、refresh_token 自动轮换、重启后自动重连——浏览器登录一次，之后一直可用。
• 静态 Bearer Token 模式：适配没有 OAuth 的服务器。
• stdio 本地进程：直接跑 npx / uvx / python 等命令，插件用 JSON-RPC over stdin/stdout 与之通信（自动拉起子进程、重连、退出时回收），无需任何远程服务器或认证。
• 工具注册：与内置客户端相同的 mcp____ 命名约定，含 DSH 工具注册表的严格 schema 清洗，并标记 isConcurrencySafe。

前置要求

• DeepSeek Harness web profile（npx @deepseek-ai/dsh web）
• Node.js ^22.19 或 >=24；PATH 里有 pnpm

安装

npx -p @deepseek-ai/dsh dsh plugin --profile web add github:hyqhyq3/dsh-mcp-manager

重启 dsh --profile web 并刷新页面。包内声明了 dsh.bundle.patch，插件自动激活——无需手动改 cordis.patch.yml。

MCP 服务器的 OAuth 提供方需要允许回环重定向（http://127.0.0.1: /mcp-manager/callback/）——DSH GUI 自身的 webserver 会接收授权码。origin 从浏览器实际地址动态派生，GUI 用任意 host/port 访问都可以。

使用

1. 打开 DSH Web UI 的 设置 → MCP。
2. ＋ 添加 MCP 服务器：
   • HTTP：名称（决定 mcp____* 前缀）、URL、认证方式（OAuth 或静态 token）。
   • stdio：名称、命令（如 npx）、参数（空格分隔，可用引号包住含空格的参数）、可选的环境变量（JSON 对象）与工作目录。
3. OAuth 服务器：点 去认证 → 浏览器打开登录页 → 同意授权后跳回，工具立即注册。
4. 静态 token 服务器：保存 token 后即连接；stdio 服务器保存后立即拉起本地进程并连接。

状态徽章：已连接 (N 个工具) / 待认证 / 认证中 / 错误。按钮：去认证、重连、删除。状态持久化在 ~/.dsh/mcp-manager.json（服务器配置 + OAuth 客户端注册信息 + token）。

Agent 看到什么

每个已连接服务器的工具以一等工具出现，例如名为 的服务器：