setup-mcp

配置 MCP

帮用户在 cosh 中配置 MCP 服务器。

用户经常从 Claude Desktop、VS Code、GitHub README 等地方复制 MCP 配置粘贴过来，但这些格式和 cosh 不兼容——多了 type 字段、顶层 key 不对、甚至 JSON 本身就有语法错误。不要试图把用户粘贴的内容直接塞给验证脚本赌运气，而是从用户的输入中理解他们要配什么，然后你自己按 cosh 的格式写出正确的配置。验证脚本只用来做最后的合并写入和校验。

cosh 的配置格式

cosh 不用 type 或 transport 字段——它看配置里有哪些字段来判断传输方式。这是最重要的一点，因为几乎所有外部来源的配置都会带一个 "type": "stdio" 之类的字段，而 cosh 不认这个。

三种传输方式，由字段决定：

本地进程（stdio）较少出现

{
  "mcpServers": {
    "mcp-name": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"],
      "env": { "DEBUG": "true" }
    }
  }
}

远程 HTTP——用户提到 streamableHttp 、streamable等字段就是 HTTP Streamable：

{
  "mcpServers": {
    "mcp-name": {
      "httpUrl": "https://mcp.example.com/v1",
      "headers": { "Authorization": "Bearer $MY_API_TOKEN" }
    }
  }
}

远程 SSE（旧版）—— 用户提供的 url 尾部是 /sse 字段就是 SSE：

{
  "mcpServers": {
    "mcp-name": {
      "url": "http://localhost:8080/sse"
    }
  }
}

其他可选字段（三种传输通用）：timeout、trust、includeTools、excludeTools。stdio 还可以用 cwd。

怎么做

1. 弄清用户要什么

用户的输入五花八门。可能是一段 JSON、一句"帮我配下 filesystem 的 MCP"、一个 npm 包名、甚至一张截图。不管输入是什么形式，你需要搞清楚三件事：

1. 用什么连接？ 如果用户提到了 npx/uvx/node/python/docker 这些命令，那就是 stdio。如果给了一个 URL，那是远程服务（HTTP 优先，除非用户明确说 SSE）。
2. 怎么认证？ 有些服务需要 API key 或 token。如果需要，密钥用 $VAR_NAME 的形式引用环境变量，别把真实密钥写进配置文件。
3. 叫什么名字？ 服务器需要一个标识名。通常可以从包名或 URL 推断出来，比如 @modelcontextprotocol/server-filesystem 就叫 filesystem。

示例 1 — 用户说"帮我配置 filesystem MCP"： → 你知道这是 npx -y @modelcontextprotocol/server-filesystem，问用户想暴露哪个目录，然后构建配置。

示例 2 — 用户粘贴了一段 Claude Desktop 的配置：

{"mcpServers": {"github": {"type": "stdio", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": {"GITHUB_TOKEN": "ghp_xxxx"}}}}

→ 从中提取有用信息：command 是 npx，args 是 ["-y", "@modelcontextprotocol/server-github"]，需要 GITHUB_TOKEN。忽略 type 字段。注意到 token 是明文的——改成 $GITHUB_TOKEN，提醒用户设置环境变量。

示例 3 — 用户给了一个 URL https://mcp.linear.app/sse 和一个 API key： → 用户给的是 URL，先确认是 HTTP 还是 SSE。路径里有 /sse 说明是 SSE，和用户确认后用 url 字段。