故障排查

修复 Cursor MCP spawn npx ENOENT

ENOENT 表示 Cursor 尝试启动 npx,但在应用可用环境中找不到它。

最后更新: 2026年6月12日

快速修复

在终端里找到 npx,并在 MCP 配置中使用完整路径。

which npx
node -p "process.env.PATH"

示例配置

把 /absolute/path/to/npx 替换成你机器上的路径。

{
  "mcpServers": {
    "filesystem": {
      "command": "/absolute/path/to/npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    }
  }
}

为什么会发生

Cursor 可能作为 GUI 应用启动,错过 .zshrc、nvm、fnm、asdf 或包管理器 shim 中的 shell 初始化。

常见问题

ENOENT 是什么意思?

表示可执行文件未找到。这里是 Cursor 找不到 npx。

这是 MCP server 的 bug 吗?

通常不是。它一般发生在服务器启动前的命令解析阶段。

可以用 npm 替代 npx 吗?

有时可以,但最安全的命令通常由 server 包的说明决定。