前言¶
在 DeepSeek Harness(DSH)里给 agent 接上外部能力,常见路径是找 MCP 服务器包名、写启动参数、改 cordis.patch.yml,再确认工具是否真的出现在 agent 工具表里。步骤多、易错,接十几个服务时更难统一管理和验收。
桥接市场(dsh-bridge-market)由社区维护者 1575088 发布,分类为联网工具。它把目录单位改成「高德地图」「飞书」「GitHub」这类应用名,在面板里点「接入」后写入当前 profile 的配置并热加载,agent 侧会多出对应的 mcp__<应用>__* 工具。下面介绍它解决什么问题、怎么用,以及接入时要注意什么。
这是什么¶
一句话:把「配一个 MCP 服务器」变成「装一个 app」。
插件在 DSH 左侧边栏提供「桥接市场」面板;目录里陈列约 50 条接入项(含一键接入、教程条目与说明卡),README 中列出一键可接的应用与所需 key 类型。每条卡片可显示「工具 N」,N 来自 agent 工具表里真实出现的 mcp__<name>__*,用于验证是否连上。
改造自 Mrxieyong/dsh-mcp-market v0.2.0(MIT),当前包版本为 0.1.0,许可证 MIT。GitHub 仓库:https://github.com/1575088/dsh-bridge-market;社区目录页:https://www.skillhub.cn/plugins/1575088/dsh-bridge-market。SkillHub 为独立社区目录,与 DeepSeek / 幻方无官方从属关系。
核心功能¶
按应用选,不按包名选¶
目录以网站或 app 为卡片,而不是 @xxx/mcp-server-yyy 这类 npm 包名。支持分类筛选、搜索,以及「免密钥」「已接入」快捷筛选。
四种条目类型¶
README 用标签区分接入方式:
- 免密钥:可直接使用(例如 DeepWiki、Context7、Playwright 等,README 列出 9 个练手项均不需申请 key)。
- 需 Key:接入时填 API key 或 token 等必填项。
- 需教程:官方仅 OAuth 时无法静态 key 一键接(Supabase、Linear、Vercel、Intercom),卡片内提供分步说明;Supabase 条目附可粘贴到「手动配置」的 JSON。
- 仅说明:当前无法真实接入(如 Figma、蓝湖),说明原因而不提供假按钮。
接入与验收¶
点「接入」后插件写入 cordis.patch.yml 托管区域,loader 热加载,一般无需为单次接入重启 DSH。MCP 握手异步,README 建议等待 5–10 秒再看「工具 N」:N > 0 表示已连上;N = 0 时需检查 key、网络或是否实为 OAuth。
右上角「手动配置」可粘贴 Claude Code 的 .mcp.json 片段,一次接一批。
agent 侧工具 bridge_market¶
插件注册 bridge_market 工具,agent 可自行列目录、接入、断开或查状态,例如口述「帮我接上高德地图,key 是 xxx」。
| action | 作用 |
|---|---|
list |
列目录,标可接入 / 已接入 / 仅说明,并提示缺哪些必填键 |
attach |
接入,如 {app: "app-amap", config: {key: "…"}} |
detach |
断开(仅移除本插件写入的桥) |
status |
列出各桥及工具数 |
实现要点(与配置安全相关)¶
每座桥对应 @deepseek-ai/dsh-mcp-client 的一条 insert,写在当前 profile 的 cordis.patch.yml 中 # >>> dsh-bridge-market managed region >>> 与结束 marker 之间;插件只重写该区间,不覆盖用户手写的其他 MCP 配置。插件会按 DSH_PROFILE_DIR、DSH_HOME、argv 与 cwd 解析 profile,避免写进 loader 不监视的路径。
安装与启用¶
让 agent 安装,或在本机对插件目录执行:
plugin_manager action: install_bundle target: <本目录的绝对路径>
装完后需要重启一次 DSH,以便插件自带的工具与侧边栏面板在启动时注册。之后新增接入通常可热加载,不必每次重启。
运行环境要求 Node.js >= 22(见 package.json 的 engines)。
典型用法¶
第 1 步:打开面板¶
左侧边栏点「桥接市场」。
| 页签 | 内容 |
|---|---|
| 发现应用 | 卡片墙、搜索、分类;点卡片或「接入」进入配置 |
| 已接入 | 已连接应用,可停用、编辑、断开;右键可看工具数 |
第 2 步:接入并验收¶
选应用 → 按需填写 key(如高德地图的 key*、GitHub 的 token*)→ 保存 → 在「已接入」查看「工具 N」。
README 建议先用 9 个免 key 条目熟悉流程,例如 DeepWiki(对 GitHub 仓库提问)、Context7(查库文档)、Firecrawl(网页转 markdown)、Exa 搜索(可不填 key,有速率限制)、Playwright、Chrome DevTools MCP 等。
第 3 步:用对话让 agent 接入(可选)¶
对 agent 说明应用名与密钥,由其调用 bridge_market 的 attach;再用 status 或面板上的「工具 N」确认。
适用场景与注意¶
适合谁: 经常在 DSH 里给 agent 接地图、协作、代码托管、搜索、数据库、本机 Docker / 文件系统等 MCP 能力,又希望少手写 YAML、能集中管理「已接入」列表的开发者。
权限与风险: 接入第三方 MCP 等于让外部代码以当前 DSH 进程权限运行;README 标明标注「社区 MCP」的条目可能有账号风控风险。Key 写在当前 profile 的 cordis.patch.yml 中(明文);面板 HTTP 接口仅接受本机 loopback。安装与接入前应阅读仓库源码与 MIT 许可证,自行评估信任边界。
常见问题(摘自 README):
- Windows 上 stdio 类命令:插件写入配置时会将
npx等改写为cmd /c npx ...;若手写配置需自行处理。 - 装了新版本却看不到面板或
bridge_market:确认已重启 DSH。 - 「工具 N」长期为 0:除 key 与网络外,确认条目是否属于「需教程」的 OAuth 场景。
结尾¶
桥接市场把 MCP 接入收敛成应用卡片、一键写入与「工具 N」验收,并保留教程与说明类条目,避免对 OAuth-only 服务假装能静态 key 接入。需要安装命令、完整应用列表与 bridge_market 参数时,以 GitHub README 为准。