dsh-mcp-oauth-client

一个面向 DeepSeek Harness（DSH） 的通用 MCP 管理与客户端桥接插件。虽然包名保留了 oauth 历史名称，但它同时支持有认证和无认证的 MCP 服务。

本插件面向 DeepSeek Harness 开发者预览版。DSH 仍在快速迭代，后续版本可能包含破坏性变更。使用前请阅读 DSH 安全说明。

功能

• 在 DSH「设置 → MCP」中可视化管理服务。
• 支持可流式 HTTP（Streamable HTTP）：无认证、OAuth 2.1 + PKCE、Bearer 令牌和自定义请求头。
• 支持本地标准输入输出（stdio）MCP：启动命令、参数、环境变量和工作目录均可配置。
• 支持添加、删除、启用、停用、重新连接和查看工具数量。
• OAuth 自动打开浏览器授权，并通过本机回调地址完成授权。
• 使用官方 MCP SDK 支持 OAuth 刷新令牌。

要求

• Node.js 20 或更高版本。
• 支持组合包和 Web 客户端扩展的 DSH 版本。

安装

npm

dsh plugin --profile web add dsh-mcp-oauth-client

本地 tarball

pnpm pack
dsh plugin --profile web add ./dsh-mcp-oauth-client-0.3.0.tgz

Git

从 Git 安装时会执行本包的 prepare 脚本。pnpm 10 及以上版本需要在 DSH profile 的 pnpm-workspace.yaml 中明确允许该构建脚本：

allowBuilds:
  dsh-mcp-oauth-client: true

然后使用可信且固定的 commit 安装：

dsh plugin --profile web add github:OWNER/REPOSITORY#COMMIT_SHA

生产环境不要使用会变化的分支名。安装前请审查源码，并只对可信代码启用构建脚本。

使用

启动 Web profile，打开「设置 → MCP」，点击「添加服务器」。

HTTP 服务可选择以下认证方式：

• 无认证：适用于公开或由网络层保护的端点。
• OAuth 2.1 / PKCE：支持动态注册，也支持填写客户端 ID 和客户端密钥。
• Bearer 令牌：发送 Authorization: Bearer <token>。
• 自定义请求头：适用于 API Key 或服务商专用请求头。

stdio 服务需要填写可执行命令；命令参数每行填写一个，环境变量使用 名称=值 格式。

插件包只安装管理器，不内置默认 MCP 地址、凭据或本地命令。通过界面添加的服务会保存到当前 profile 的 cordis.patch.yml。

手动配置

HTTP OAuth 服务示例：

- insert:
    - id: mcp-example
      name: dsh-mcp-oauth-client
      config:
        entryId: mcp-example
        manager: false
        serverName: example
        transport: streamable-http
        authType: oauth
        resourceUrl: https://mcp.example.com/mcp

stdio 服务示例：

- insert:
    - id: mcp-files
      name: dsh-mcp-oauth-client
      config:
        entryId: mcp-files
        manager: false
        serverName: files
        transport: stdio
        command: npx
        args:
          - -y
          - '@modelcontextprotocol/server-filesystem'
          - /path/to/allowed/directory

只有管理器条目需要设置 manager: true；组合包提供的管理器已经承担该角色。

安全说明

界面中填写的凭据会以明文写入当前 DSH profile 的 cordis.patch.yml，请勿将该文件提交到 Git。OAuth 访问令牌和刷新令牌只保存在插件进程内存中，不会由本插件持久化。详见 SECURITY.md。

开发与验证

pnpm install
pnpm run check
pnpm run pack:check

将当前工作目录安装到开发 profile：

dsh plugin --profile web add /absolute/path/to/dsh-mcp-oauth-client

检查组合后的 profile：

dsh --profile web --dump-config

许可证

MIT

反馈与发现

欢迎在 GitHub 仓库 提交反馈或 bug。仓库已使用 dsh-plugin 话题，便于在 DSH 社区中发现。