💡 建议：文档增加 MCP 服务器配置示例

[dragonkin]

背景

deepseek-harness 已支持通过 cordis.patch.yml 的 insert 块挂载 MCP 服务器（如 @deepseek-ai/dsh-mcp-client），工具会以 mcp____ 的形式注册到模型工具列表。但官方文档缺少具体配置示例，新用户不知道如何接入。

建议

在 docs/ 下新增一节 MCP 配置指南，包含：

1. 基础结构（cordis.patch.yml 的 insert 块语法）
2. GitHub MCP 完整示例（含 token 传递）
3. Filesystem MCP 完整示例（含目录白名单）
4. streamable-http 传输示例（远程 MCP 服务器）
5. 常见问题排查（端口占用、MCP 服务器启动失败等）

实测配置（已验证可用）

- insert:
    - id: mcp-github
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: github
        transport: stdio
        command: npx
        args: ['-y', '@modelcontextprotocol/server-github']
        env:
          GITHUB_PERSONAL_ACCESS_TOKEN: <your-token>
          GITHUB_TOKEN: <your-token>
        toolCallTimeoutMs: 30000

    - id: mcp-filesystem
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: filesystem
        transport: stdio
        command: npx
        args:
          - '-y'
          - '@modelcontextprotocol/server-filesystem'
          - 'E:\AI agent'
        toolCallTimeoutMs: 30000

[dragonkin]

server-github 读取的环境变量是 GITHUB_PERSONAL_ACCESS_TOKEN，不是 GITHUB_TOKEN，两者都设置可保证兼容
显式 env 会合并到 MCP 子进程环境（父进程的凭据类变量会被安全 scrub 掉）
!!js process.env.XXX 表达式在部分部署的 loader 求值环境中不可用（process 未定义），直接写字面量最稳妥
修改 cordis.patch.yml 后需重启 dsh web 生效

[Huer-y]

https://deepseek-harness.github.io/deepseek-harness/reference/config-catalog
我在这里的文档看到了mcp配置的config
`/** Configuration for one stdio or Streamable HTTP MCP server. */
export type Config = StdioConfig | StreamableHttpConfig

/** Config for connecting to an MCP server via a spawned child process over stdio. /
export interface StdioConfig {
/* Selects child-process stdio transport. /
transport: 'stdio'
/*

• Stable local namespace for this server's model-facing tool names
• (mcp__<serverName>__<rawName>). Must match [A-Za-z0-9_-]{1,32} and be
• unique across live mcp-client instances.
  /
  serverName: string
  /* Executable used to start the server. /
  command: string
  /* Arguments passed directly, without shell interpolation. /
  args: string[]
  /* Extra env vars merged on top of scrubbed ambient env. /
  env: Record<string, string>
  /* Working directory for the child process. /
  cwd: string
  /* Per-tool-call timeout in milliseconds. /
  toolCallTimeoutMs: number
  /* Fail plugin activation when the initial connection or tool synchronization fails. /
  failOnStartupError: boolean
  /* Automatic reconnect policy after a lost connection; omission uses the defaults. */
  reconnect?: ReconnectConfig
  }

/** Config for connecting to an MCP server over Streamable HTTP (SSE). /
export interface StreamableHttpConfig {
/* Selects Streamable HTTP transport. /
transport: 'streamable-http'
/*

• Stable local namespace for this server's model-facing tool names
• (mcp__<serverName>__<rawName>). Must match [A-Za-z0-9_-]{1,32} and be
• unique across live mcp-client instances.
  /
  serverName: string
  /* MCP endpoint URL. /
  url: string
  /* Additional headers attached to MCP requests. /
  headers: Record<string, string>
  /* Per-tool-call timeout in milliseconds. /
  toolCallTimeoutMs: number
  /* Fail plugin activation when the initial connection or tool synchronization fails. /
  failOnStartupError: boolean
  /* Automatic reconnect policy after a lost connection; omission uses the defaults. */
  reconnect?: ReconnectConfig
  }

/** Automatic reconnect policy for one MCP server connection. /
export interface ReconnectConfig {
/* Reconnect automatically after a lost connection (default true). /
enabled?: boolean
/* First reconnect delay in milliseconds; doubles per consecutive failed attempt (default 500). /
initialDelayMs?: number
/* Backoff ceiling in milliseconds; also the uptime after which the attempt budget resets (default 30000). /
maxDelayMs?: number
/* Consecutive failed attempts per outage before giving up for good (default 10). */
maxAttempts?: number
}`

[weijiafu14]

补一份已经按真实 DSH 用户安装路径跑过的社区示例：
https://github.com/weijiafu14/pi2dsh/tree/main/examples/tui-mcp

它覆盖两条路线：

1. 官方 dsh-mcp-client 适合普通声明式 server 配置；
2. 需要管理面、lazy tool discovery、OAuth、resources/prompts、MCP Apps、elicitation/sampling 时，可安装 pi2dsh + pi-mcp-adapter，仍然只用 dsh plugin --profile ... add ...。

示例新增了真实 Atlassian Remote MCP 的 OAuth 配置与 /mcp-auth atlassian 流程；Web 和 dsh-TUI 都已做真实浏览器回调和模型工具调用。它不能替代官方文档，但可以先给这里需要完整可运行样例的用户使用。