MCP client 起不来（Brave MCP WinError 2 / npx 未跑起来）

你会遇到什么

配置 MCP 客户端（如 Brave Search MCP）后 deepcode mcp 报 WinError 2 / 找不到命令；npx 没跑起来。客户端配置没问题，是启动环境有问题。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

MCP 客户端靠 npx/Node 环境启动：

WinError 2 是 Windows 的 "系统找不到指定的文件"——它不是 MCP 配置错，而是 deepcode 拉起子进程时找不到 npx.exe。GUI/服务环境里的 PATH 往往和终端里不一样（有些服务环境甚至不继承用户 PATH），所以终端里 npx 好好的，客户端一启动就 WinError 2。

另一个隐蔽点：npx 首次运行要现场下载包，这步是网络操作，超时也算"启动失败"——所以先手动 npx -y <包名> 预下载一次，把"网络问题"和"配置问题"两个变量拆开。

一步步来

1. 确认 Node/npx 可用 — 必做

npx --version

报找不到命令就先装 Node 并确认 PATH。

2. 手动先跑一次 npx 预下载 — 必做

npx -y <mcp包名>

先把包拉下来，再配置到 deepcode，避免配置后首次启动超时。

3. Windows 注意 PATH 与 cmd 权限 — 必做

服务类 MCP 用完整路径配置；Windows 下注意 cmd 执行权限。

怎么确认修好了

MCP 客户端正常启动（预期形态）：

deepcode mcp
→ MCP 服务正常启动/握手（不再报 WinError 2）

npx --version 正常输出版本。

其它环境的表现

症状

配置 MCP 客户端（如 Brave Search MCP）后 deepcode mcp 报 WinError 2 / 找不到命令；npx 没跑起来。

原因

MCP 客户端靠 npx/Node 环境启动；Node 不在 PATH、或 npx 首次下载超时都会导致启动失败。

解法

1. 确认 Node/npx 可用：npx --version。
2. 手动先跑一次 npx 预下载（npx -y <mcp包>），再配置到 deepcode。
3. Windows 下注意 PATH 与 cmd 权限；服务类 MCP 用完整路径配置。