menotbobbybrown/dsh-plugin-mcp

dsh-plugin-mcp

适用于 DeepSeek Harness（dsh）的通用模型上下文协议（MCP）桥接插件

npm version
License: MIT
DeepSeek Harness

dsh-plugin-mcp 是 DeepSeek Harness 的官方标准插件，可将你的 DeepSeek 智能体无缝连接到整个 模型上下文协议（MCP） 服务器生态系统，并具备与 Claude Code 完全对等的功能。

请查看我们完整的 ROADMAP.md，了解当前功能与即将到来的里程碑。

功能特性

- 🔌 通用 MCP 支持：可通过 stdio、sse 或 websocket 运行任意 MCP 服务器。
- 🚀 万级服务器规模引擎：默认休眠的进程池，配合 JIT 工作进程激活与 LRU 空闲进程回收器（即使有 1 万个服务器也能保持内存占用低于 100MB）。
- ⚡ 亚毫秒级 BM25 倒排索引：在不到 0.5ms 内评估数千个服务器中的 20,000 多个工具定义。
- 🎯 动态 Token 预算分配器：严格限制上下文窗口上限（例如最多 1,500 个 token），并采用渐进式 schema 披露。
- 💾 两级 Schema 缓存（L1/L2）：即时内存缓存 + 磁盘快照，消除启动时 tools/list 握手延迟。
- 📊 企业级遥测：高分辨率 p50、p95 和 p99 工具延迟直方图与指标。
- 📁 多作用域配置：自动加载用户全局（~/.dsh/mcp.json）、项目本地（.dsh/mcp.json）以及配置文件级别的配置。
- 🛡️ 执行权限：细粒度的 allow、ask 和 deny 权限规则，保障工具安全。
- 🔒 企业级安全引擎：自动密钥脱敏（API 密钥/Bearer token）、命令注入防护以及路径遍历防御。
- 🚦 熔断器与速率限制：容错机制可防止失控循环，并避免在故障服务器上耗尽 token 配额。
- 📜 安全审计日志：以结构化 JSON 记录所有工具调用、权限判定和安全事件。
- 🔍 语义工具搜索：TF-IDF token 相关性评分，确保只有相关工具被注入提示上下文。
- 🗜️ 上下文溢出防护：截断超大输出（>30k 字符），并将其存储为本地工件，附带结构化预览。
- 🛠️ 自动工具桥接：通过 JSON Schema 验证，将 MCP 工具动态注册到 DSH 工具注册表中。
- 📂 资源与提示桥接：将 MCP 资源和提示模板直接暴露到智能体上下文中。
- ⚡ 弹性执行：隔离的服务器生命周期、按服务器超时控制以及非阻塞错误处理。
- 🏷️ 清晰的命名空间：自动为工具名称添加前缀（github_create_issue、postgres_query），以避免跨服务器名称冲突。
- 🧩 Cordis 原生：直接构建于 Cordis 生命周期钩子（ctx.provide、ctx.on('ready')、ctx.on('dispose')）之上。

⚡ 一行 Docker 快速开始

用 1 条命令启动 DeepSeek Harness + MCP 桥接 + PostgreSQL + 文件系统：

克隆并启动完整技术栈
git clone https://github.com/menotbobbybrown/dsh-plugin-mcp.git
cd dsh-plugin-mcp

在 Linux/macOS 上：
./scripts/quickstart.sh

在 Windows PowerShell 上：
.\scripts\quickstart.ps1

安装

在 DeepSeek Harness（dsh）中

从 GitHub 添加
dsh plugin --profile web add "github:menotbobbybrown/dsh-plugin-mcp"

或通过 npm 安装
dsh plugin --profile web add dsh-plugin-mcp

💻 CLI 命令（dsh-mcp）

像 Claude Code 一样，从终端无缝管理 MCP 服务器：

浏览经过验证的内置服务器目录
npx dsh-mcp catalog

一键安装热门服务器（GitHub、Postgres、SQLite、Brave Search 等）
npx dsh-mcp install github --scope user
npx dsh-mcp install postgres --scope project
npx dsh-mcp install sqlite --scope project

列出所有已配置的 MCP 服务器及其生效范围
npx dsh-mcp list

添加自定义的用户全局 MCP 服务器（~/.dsh/mcp.json）
npx dsh-mcp add custom_srv --scope user -- npx -y my-mcp-server

添加项目本地的 MCP 服务器（.dsh/mcp.json）
npx dsh-mcp add postgres --scope project -- npx -y @modelcontextprotocol/server-postgres postgresql://localhost:5432/mydb

添加 SSE 远程 MCP 服务器
npx dsh-mcp add weather --transport sse -- https://weather-mcp.example.com/sse

测试连接、延迟和工具发现
npx dsh-mcp test github

从配置中移除 MCP 服务器
npx dsh-mcp remove github --scope user

配置

将插件添加到你的 dsh.config.yaml：

plugins:
mcp:
prefixToolNames: true
prefixDelimiter: "_"
defaultTimeoutMs: 60000
servers:
GitHub MCP 服务器
github:
type: stdio
command: npx
args: ["-y", "@modelcontextprotocol/server-github"]
env:
GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_TOKEN}"

本地文件系统 MCP 服务器
filesystem:
type: stdio
command: npx
args: ["-y", "@modelcontextprotocol/server-filesystem", "./workspace"]

PostgreSQL 数据库 MCP 服务器
postgres:
type: stdio
command: npx
args: ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost:5432/mydb"]

通过 SSE 连接的远程 MCP 服务器
remote_service:
type: sse
url: "https://mcp.example.com/sse"
headers:
Authorization: "Bearer ${API_KEY}"

编程式用法（Cordis API）

import { Context } from 'cordis';
import * as McpPlugin from 'dsh-plugin-mcp';

const ctx = new Context();

ctx.plugin(McpPlugin, {
servers: {
github: {
command: 'npx',
args: ['-y', '@modelcontextprotocol/server-github'],
},
},
});
// 访问已注册的 MCP 工具与服务
const tools = await ctx.mcp.getAllTools();
const statuses = ctx.mcp.getStatuses();

开发与测试
bash
安装依赖
npm install

运行单元测试
npm test

构建包
npm run build

许可证

MIT © DeepSeek Harness Community

🤝 贡献

热烈欢迎贡献！无论你是报告问题、提出适配器、优化性能，还是修复 bug，都请查看我们的贡献指南。

1. Fork 项目
2. 创建你的功能分支（git checkout -b feat/AmazingFeature）
3. 提交你的更改（git commit -m 'feat: add some AmazingFeature'）
4. 推送到分支（git push origin feat/AmazingFeature）
5. 打开一个 Pull Request

📄 许可证与社区

基于 MIT 许可证分发。更多信息请参见 LICENSE。

用 💙 为 DeepSeek Harness 社区构建。