MCP servers 报错解决方法

spawn npx ENOENT

在windows11中使用visual studio code 安装 cline 插件 配置 MCP Servers 时，出现错误提示：spawn npx ENOENT，而无法运行servers。

原因与系统安装的nodejs及其npm/npx 多版本多路径配置有关。

Microsoft Windows [版本 10.0.26100.3775]
(c) Microsoft Corporation。保留所有权利。

C:Usersliuyuhua>where node
C:Program Filesnodejsnode.exe

C:Usersliuyuhua>where npx
C:Program Filesnodejsnpx
C:Program Filesnodejsnpx.cmd
C:UsersliuyuhuaAppDataRoamingnpmnpx
C:UsersliuyuhuaAppDataRoamingnpmnpx.cmd

C:Usersliuyuhua>npm --version
10.4.0
C:Usersliuyuhua>npx --version
10.4.0
C:Usersliuyuhua>node -v
v20.11.0

解决办法是完全卸载并重新安装Node.js

• 卸载Node.js

  通过 开始->添加或删除程序->Node.js-> 单机三个小圆点->卸载

  又或者通过 控制面板 -> 程序和功能 -> Node.js -> 右键单击 -> 卸载

• 删除残留目录：

C:Program Filesnodejs  
C:UsersliuyuhuaAppDataRoamingnpm  
C:UsersliuyuhuaAppDataRoamingnpm-cache  

• 重新下载并安装最新版 Node.js LTS 版本
  官网https://nodejs.org/
  安装完成后验证一下安装

 C:Usersliuyuhua>node -v  
 v22.15.0  
 C:Usersliuyuhua>npm -v  
 10.9.2  
 C:Usersliuyuhua>npx -v  
 10.9.2

invalid MCP settings schema

json格式严格，是mcpServers不是servers。其他参数也需严格按照以下格式填写。
一般情况下，我们能够找到的MCP Servers的 NPX 配置如下：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

这在mac OS上没有问题，但在windows 系统下，需要修改如下。

{
  "mcpServers": {
    "filesystem": {
      "command": "cmd",
      "args": [
        "/c",
        "npx", #
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "D:/Gitee/cline",
        "/other/path/to/other/allowed/dir"
      ]
    }
  }
}