前言¶
DeepSeek Harness (DSH) 允许智能体通过 MCP (Model Context Protocol) 调用外部工具。但在实际开发中，你往往需要针对不同会话使用不同的 MCP 服务器（例如：一个会话连接数据库，另一个连接代码仓库）。手动管理全局配置和项目配置容易冲突，且无法灵活控制单个会话的可用工具。dsh-mcp-master 解决了这个问题，它将 MCP 服务器的管理下沉到会话级别，并提供了项目与全局配置的统一入口。
插件简介¶
dsh-mcp-master 是 DeepSeek Harness 的一个工作流插件。由用户 lastorder 维护。它为 DSH 提供了一个位于 Composer 行的 MCP 服务器选择器，支持从全局目录和项目目录加载服务器列表，提供 OAuth 认证支持和项目服务器信任审查机制。
核心功能¶
- 会话级选择器：在每个会话的 Composer 行中显示
[🔌 MCP 2 ●]。点击可查看并勾选当前会话启用的服务器。 - 多目录管理：支持读取全局配置
~/.dsh/mcp-master/mcp.json和项目级配置（.mcp.json,.cursor/mcp.json,.vscode/mcp.json,.dsh/mcp.json）。 - 信任审查：项目中的 MCP 服务器必须被信任才能运行。如果服务器被标记为“未信任”，会显示具体的命令/URL并提供“Trust & use”按钮。
- OAuth 认证：支持 MCP 授权规范，可使用 OAuth 提供商动态注册客户端进行签名，Token 存储在
~/.dsh/mcp-master/state.中。 - 变量解析：支持
${VAR},${workspaceFolder}等环境变量解析。 - 传输协议：支持 stdio, Streamable HTTP 和 legacy HTTP。
安装与启用¶
该插件通过 DSH 的插件目录安装。安装后，它会生成 cordis.patch.yml 配置文件来注入 Host 和 Client 模块。
安装完成后必须重启 DSH 才能生效。
典型用法¶
- 配置服务器：在项目根目录创建
.mcp.json，或在全局目录~/.dsh/mcp-master/mcp.json中编写mcpServers配置。配置格式遵循 MCP 标准的mcpServers对象。 - 创建会话：打开新会话，Composer 行会出现 MCP 服务器数量指示器。
- 信任项目服务器：如果是首次运行项目中的服务器，点击状态点或行中的“Trust & use”按钮进行授权。
- 切换会话服务器：在会话运行过程中，随时点击 Composer 行的 MCP 指示器，勾选或取消勾选服务器，即可在当前会话中注册/注销对应工具。
适用场景与注意事项¶
- 适用场景：需要在不同会话间切换不同外部工具链的 DSH 用户；管理多项目环境变量的开发者。
- 注意：项目服务器必须被信任才能运行。OAuth Token 存储在
~/.dsh/mcp-master/state.中，应视为敏感凭证文件。日志和 UI 会自动屏蔽代码、令牌和 Bearer 值。服务器进程在会话结束后 2 分钟停止，无会话的工作区在 15 分钟空闲后关闭。 - 安全：插件以当前 DSH 进程的权限运行，安装前请检查源码与许可证。
生态背景¶
DSH 理念是「一切皆插件」。本插件收录自社区目录，与 DeepSeek 或幻方无官方从属关系。
