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:\Users\liuyuhua>where node
C:\Program Files\nodejs\node.exe

C:\Users\liuyuhua>where npx
C:\Program Files\nodejs\npx
C:\Program Files\nodejs\npx.cmd
C:\Users\liuyuhua\AppData\Roaming\npm\npx
C:\Users\liuyuhua\AppData\Roaming\npm\npx.cmd

C:\Users\liuyuhua>npm --version
10.4.0
C:\Users\liuyuhua>npx --version
10.4.0
C:\Users\liuyuhua>node -v
v20.11.0

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

• 卸载Node.js

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

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

• 删除残留目录：

C:\Program Files\nodejs\  
C:\Users\liuyuhua\AppData\Roaming\npm  
C:\Users\liuyuhua\AppData\Roaming\npm-cache  

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

 C:\Users\liuyuhua>node -v  
 v22.15.0  
 C:\Users\liuyuhua>npm -v  
 10.9.2  
 C:\Users\liuyuhua>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"
      ]
    }
  }
}

来源链接：https://www.cnblogs.com/aiparallelworld/p/18873147