Cursor本地MCP服务安装失败问题解决

Cursor本地MCP服务安装失败问题解决

问题说明：

我安装的是文件系统MCP服务器。

1. Cursor中NPX服务配置：mcp.json

   {
     "mcpServers": {
       "filesystem": {
         "args": [
           "-y",
           "@modelcontextprotocol/server-filesystem",
           "D:/SoftwareDevelopmentKit/MCPServer"
         ],
         "command": "npx"
       }
     }
   }
   

2. 保存，打开Cursor设置开启服务查看，服务安装失败

   

问题分析：

大部分MCP服务支持的nodeJS版本是18以上，我是22，没有问题。

直接在终端使用npx命令运行MCP服务，查看终端输出。

cmd /c npx -y @modelcontextprotocol/server-filesystem D:\SoftwareDevelopmentKit\MCPServer

绿色字说是错误模块，给了文件路径，意思就是说npx 在临时安装并运行 @modelcontextprotocol/server-filesystem 这个MCP服务器时，其内部依赖的SDK模块文件路径不对，本质上是npm包的模块系统不兼容或者损坏了不完整。

问题解决：

清理损坏的缓存文件和不完整的临时文件，让npm自动使用正确的模块格式重新下载完整的文件和包。

1. 彻底清除npm缓存

   npm cache clean --force
   

2. 直接删除npx的临时安装文件夹

   rmdir /s /q "C:\Users\user\AppData\Local\npm-cache\_npx"
   

   \Users\user\AppData\Local\npm-cache_npx: 这个就是之前MCP服务运行失败，终端绿色字体输出的url里的路径

3. 重新使用npx命令运行MCP服务，让npx重新下载完整的包

   cmd /c npx -y @modelcontextprotocol/server-filesystem D:\SoftwareDevelopmentKit\MCPServer
   

没有问题，运行成功！

打开Cursor设置开启服务，服务安装成功！