dsh-skill-mcp-bridge

dsh（DeepSeek Harness）项目桥接插件：自动导入 .claude/.agents/.trae 下的 skills，并桥接工作区 MCP 服务器（HTTP/SSE 与 stdio 双传输），全部功能由 GUI 开关控制、状态持久化。

• 技能导入：.claude/skills、.agents/skills、.trae/skills，以及 .claude/agents、.claude/commands
• MCP 桥接：读取 .mcp.json / .trae/mcp.json / .claude/settings.json 中的 mcpServers，注册为 dsh 工具（mcp__<server>__<name>）
• 控制面板：设置页 + 工具视图双面板（开关、扫描、重连、状态）
• 自动监听：4 秒轮询文件指纹，skills/MCP 配置变更自动重载

安装

方式一：dsh plugin add（推荐）

dsh CLI 内置插件安装命令（转发 pnpm），git 仓库与 npm 包均可：

# git 仓库源
dsh plugin --profile web add github:cstarc/dsh-skill-mcp-bridge

# 等价形式（与 dsh-at-file 的 git+https 依赖同机制）
dsh plugin --profile web add git+https://github.com/cstarc/dsh-skill-mcp-bridge.git

• 自动写入 profile package.json 依赖与 pnpm-lock.yaml
• 包内 cordis.patch.yml 会被 loader 自动应用，装完即激活，无需手动配置
• 若已发布到 npm registry，裸包名同样可用：dsh plugin --profile web add dsh-skill-mcp-bridge

方式二：手动放置（备选）

将本仓库复制到 dsh web profile 的 node_modules：

cp -r dsh-skill-mcp-bridge /data/.dsh/profiles/web/node_modules/

（profile 使用 pnpm nodeLinker: hoisted，直接放目录即可被解析。）

然后手动在 /data/.dsh/profiles/web/cordis.patch.yml（用户补丁层，升级不覆盖）追加：

- insert:
    - id: dsh-skill-mcp-bridge
      name: dsh-skill-mcp-bridge

注意：手动放置的包不会被自动激活，必须补 insert 行；dsh plugin add 方式无需此步。

3. 重启与验证

重启 dsh 后插件自动加载（无需审批）。可在不重启的情况下先验证组合：

dsh --profile web --dump-config   # 应看到 dsh-skill-mcp-bridge 行

使用

技能开关

面板位于 设置页 →「项目桥接（Skills + MCP）」 与 工具视图：

开关	说明
.claude/skills	导入 .claude/skills/*/SKILL.md（rank 250）
.agents/skills	导入 .agents/skills（rank 260）
.trae/skills	导入 .trae/skills（rank 270）
.claude/agents	导入 .claude/agents/*.md（rank 251，随 claude 开关）
.claude/commands	导入 .claude/commands/**/*.md（rank 252，随 claude 开关）

frontmatter 语义

字段	行为
name	技能名（必须 kebab-case）
description	技能描述；缺省取正文首段（≤1536 字符）
when_to_use / when-to-use / whenToUse	触发时机
disable-model-invocation: true	模型不会自动触发该技能，在输入框发送 /技能名 手动调用
user-invocable: false	禁止用户手动调用
metadata	透传元数据

MCP 服务器

支持两种配置形态（按 .trae/mcp.json → .mcp.json → .claude/settings.json 顺序合并覆盖）：

// .mcp.json — HTTP/SSE 传输
{
  "mcpServers": {
    "my-http-server": {
      "url": "https://example.com/mcp",
      "headers": { "Authorization": "Bearer xxx" }
    }
  }
}

// .mcp.json — stdio 传输（换行 JSON-RPC）
{
  "mcpServers": {
    "my-stdio-server": {
      "command": "node",
      "args": ["mcp-stdio-bridge.js"],
      "env": { "MCP_SERVER_URL": "http://10.0.0.1:9090/mcp" }
    }
  }
}

注册的工具名为 mcp__<server>__<原始名>。每个 server 可用独立开关；disabled: true 的 server 默认关闭。

状态持久化

开关状态保存于 <工作区>/.claude/skills-state.json：

{
  "claude": true,
  "agents": true,
  "trae": true,
  "mcp": { "dbquery-mcp": true, "hundsun": true }
}

诊断日志：<工作区>/.claude/bridge-diag.log（截断 8000 字符）。

架构

Host（Node.js）                         Client（浏览器）
┌─────────────────────────────┐       ┌──────────────────────────┐
│ skills.registerProvider     │       │ settings.section 面板     │
│   · .claude/.agents/.trae   │       │ tool.view.cordis 面板     │
│   · frontmatter 解析        │       │                          │
│ tools.register (defineTool) │◄─────►│ ctx.remote.$mount        │
│   · MCP HTTP/SSE (fetch)    │ typert │  ctx.reflect.get(         │
│   · MCP stdio (子进程)      │ RPC    │    "remote.skillMcpBridge")│
│ timer 指纹轮询             │       │                          │
└─────────────────────────────┘       └──────────────────────────┘

• 面板 RPC 走 Typert Remote（src-json 宽松 codec），host 端 @Remote 装饰器方法 + ctx.typert.register(MANIFEST)。
• 工具注册使用 @deepseek-ai/dsh-tools 的 defineTool（参数 DSL 不支持属性级 enum/const/oneOf，桥接时已做 schema 白名单净化）。
• 网络访问受限环境通过子进程 node -e 执行 fetch（沙箱无 fetch）。

构建

esbuild src/index.js  --bundle --format=esm --platform=node   --outfile=lib/index.js  --external:node:* --target=es2020
esbuild src/client.js --bundle --format=esm --platform=browser --outfile=lib/client.js --log-level=warning

--target=es2020 必要：让 esbuild 转译 TC39 装饰器（Node 原生不支持装饰器语法）。

兼容性

• dsh web profile（nodeLinker: hoisted 布局）
• Client 平台包注入：@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-tool、@deepseek-ai/dsh-client-ui-settings
• Node.js ≥ 18（MCP HTTP 子进程使用全局 fetch）

License

MIT