怎么配置MCP服务器给harness用？

[MaoJianwei]

怎么配置MCP服务器给harness用？

[sjh9714]

MCP 在 DSH 里没有独立的 mcp.json，一个服务器就是 profile patch 里的一行插件配置，用官方的 @deepseek-ai/dsh-mcp-client。下面的字段是按 packages/mcp/mcp-client/src/index.ts 的 schema 写的，我在 rc.7 上实际跑通过。

编辑 ~/.dsh/cordis.patch.yml（想只对某个项目生效就用项目里的 .dsh/cordis.patch.yml）：

- insert:
    - id: mcp-github
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: 'github'
        transport: stdio
        command: 'npx'
        args: ['-y', '@modelcontextprotocol/server-github']

远程服务器换成 http 那一支：

- insert:
    - id: mcp-remote
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: 'remote'
        transport: streamable-http
        url: 'https://mcp.example.com'
        headers:
          Authorization: !!js process.env.MY_TOKEN

几个容易踩的点

• transport 只有 stdio 和 streamable-http 两种。stdio 支路的字段是 command / args / env / cwd，http 支路是 url / headers，两边混写会 schema 报错。
• serverName 必须全局唯一，重名会直接报 serverName "x" is already in use by another mcp-client instance。id 也要唯一，重复的 loader id 会让 dsh web 启动失败而不是跳过。
• 密钥不要写死在 YAML 里，用 !!js process.env.XXX 引用环境变量。
• 每个服务器一行 insert，配好后重启 dsh web，用 dsh --profile web --dump-config | grep mcp- 确认行确实合成进去了。
• 工具名和 Claude Code 那边完全一致，都是 mcp__<server>__<tool>，所以原来写的提示词和权限规则里的工具名不用改。

补充一点，如果 patch 里写了 profile 解析不到的包，DSH 是启动直接失败而不是警告，所以先确认 @deepseek-ai/dsh-mcp-client 已经装进 profile 再写这些行。

利益相关，我在做一个把 Claude Code 配置搬进 DSH 的工具，上面这些行就是它自动生成的，.mcp.json 里的服务器会原样转成这个格式：https://github.com/sjh9714/dsh-movein 。不想装工具的话照着上面手写完全一样。

[MaoJianwei]

感谢！我明天试试

[MaoJianwei]

如何把“@deepseek-ai/dsh-mcp-client”装进profile呢？需要运行什么安装命令吗？

[MaoJianwei]

~/.dsh/cordis.patch.yml 这个文件好像不存在？

[MaoJianwei]

nano ~/.dsh/profiles/web/cordis.patch.yml 修改这个文件，成功了

[sjh9714]

需要装，而且这里有个坑，我刚在干净环境里实测了两遍。

直接装会拿到一个很老的版本。

dsh plugin --profile web add @deepseek-ai/dsh-mcp-client

装出来是 0.0.1-rc.1，因为这个包的 npm dist-tag 还停在旧版：

{ latest: '0.0.1-rc.1', next: '0.1.0-rc.7' }

所以要跟宿主 dsh 版本对齐着装。 先看自己的版本，再按这个版本号 pin：

dsh --version                                              # 比如 0.1.0-rc.7
dsh plugin --profile web add @deepseek-ai/dsh-mcp-client@0.1.0-rc.7

这样装出来就是 0.1.0-rc.7，我这边验证过。

另外会看到一条 warning，那是正常的，不用管：

dsh: warning: @deepseek-ai/dsh-mcp-client declares no dsh.bundle
  — installed as a plain dependency, not a profile layer

因为 mcp-client 本身不是 bundle，它不会自己往 profile 里插行。激活方式就是你手动在 cordis.patch.yml 里写那条 insert（也就是上一条回复里的 YAML），一个服务器一行。装包 + 写行，两步都做完再重启 dsh web 就能用了。

顺序建议是先装包再写行。反过来的话，profile 里解析不到这个包时 dsh web 会直接启动失败而不是警告，那时候连 UI 都进不去，只能手动去改 YAML。

[PerryLink]

注：本条评论原文因编码问题曾显示为乱码，已重建为可读版（2026-09-07）。

可以这样配：MCP 服务器通过 @deepseek-ai/dsh-mcp-client 挂载，写在 cordis.yml（或 profile patch）里，config 参数支持 stdio 与 Streamable HTTP 两种（stdio 写 transport: 'stdio' + command/args，HTTP 写 URL）；挂上后工具名形如 mcp__<服务器名>__<工具名>，直接可用。

如果嫌手写 yml 麻烦，可以试试 dsh-mcp-panel，它就是干这个的 MCP 管理面板——用 append-only patch 机制（多文件 + 校验），/mcp 命令可视化管理服务器与工具授权，支持 CRUD，避免手写 yml 出错：dsh plugin --profile web add dsh-mcp-panel

[weijiafu14]

除了手写 cordis.patch.yml 的官方 client 路线，现在也可以直接用标准 .mcp.json，由现成能力包负责管理和连接：

dsh plugin --profile web add pi2dsh
dsh plugin --profile web add pi-mcp-adapter

项目根目录使用通用的 .mcp.json：

{
  "mcpServers": {
    "example": {
      "command": "npx",
      "args": ["-y", "your-mcp-server"]
    }
  }
}

远程服务器改成 url；OAuth server 加 auth: "oauth" 后运行 /mcp-auth <server>。dsh-TUI 还可以用 /pi-mcp setup 和 /pi-mcp 做导入、状态、tool list、启停和重连。

完整示例：
https://github.com/weijiafu14/pi2dsh/tree/main/examples/tui-mcp

这条路线不会替换官方 dsh-mcp-client；只是让已有标准 MCP 配置和更完整的 MCP 能力包可以直接进入 DSH。