前言¶
DSH(DeepSeek Harness)采用插件化架构。在使用 DSH 进行智能体开发时,管理 MCP(Model Context Protocol)服务器通常需要手动配置或依赖全局设置。dsh-project-mcp-manager 扩展了原版 DSH 代码,在项目层和用户层提供了更完整的 MCP 管理能力。
是什么¶
这是一个基于原版 DSH 代码扩展的插件,由 wldxiaobai 维护。它的核心作用是解决多项目环境下的 MCP 配置分散问题,允许开发者将 MCP 服务器配置写入项目目录,并在会话启动时自动加载。
核心功能¶
该插件提供了以下核心能力:
* 项目级 MCP 自动加载:在项目根目录下创建配置文件即可自动挂载。
* 配置文件支持:支持 .dsh/mcp.yml、.dsh/mcp.(json) 以及只读的 .mcp.json。
* 配置热重载:修改配置文件后,DSH 进程会自动重新加载,无需重启。
* 工具可见性作用域:工具的可见性基于会话的当前工作目录(CWD)进行隔离。
* CLI 工具:提供 dsh-mcp 命令行工具用于写入配置。
* 多层级配置源:支持多层级配置覆盖。
* 官方通信:使用官方 @deepseek-ai/dsh-mcp-client 进行通信。
安装与启用¶
插件通过 Bundle Patch 的方式挂载。在安装前请确保已安装 DSH。
前置要求¶
- 安装 DSH:
npm install -g @deepseek-ai/dsh(或其他源)。
安装步骤¶
使用官方推荐命令安装最新版本:
dsh plugin --profile web add dsh-project-mcp-manager@latest
版本兼容性说明¶
- v0.7.x:需要 DSH 版本
>= 0.2.0-rc.2。 - v0.6.0:如果使用 DSH
0.1.5,请使用此版本。
典型用法¶
1. 创建配置文件¶
在项目根目录下创建 .dsh/mcp.yml 文件,并写入 MCP 服务器配置。
2. 使用 CLI 工具¶
插件提供了 dsh-mcp CLI 工具来管理配置。
注意事项¶
- 无 UI:该插件仅提供核心功能,没有图形界面。
- 配置机制:官方配置是基于 profile-layer Cordis patch 加上
plugin_manager。 - 传输类型:MCP 传输类型由官方客户端决定,该插件不负责底层传输。
结尾¶
该插件通过项目级配置文件和热重载机制,简化了在多项目场景下管理 MCP 服务器的流程。更多细节请参考项目文档或源码。
GitHub 仓库