如何解决Windows下MCP报错问题:Error executing MCP tool: Not connected

在使用Cursor的MCP(Model Context Protocol)工具时,许多Windows用户会遇到“Error executing MCP tool: Not connected”的报错。这一问题通常由MCP服务未正确配置或路径问题导致。本文将基于实际案例,提供一套完整的解决方案,帮助您快速修复连接错误。

问题原因分析

以下原因可能导致MCP工具无法连接:

  1. MCP服务未安装或未运行
    Cursor依赖本地运行的MCP服务,若服务未启动,工具调用会失败。

  2. 路径配置错误
    Windows环境下,使用npx命令或相对路径可能因环境变量问题导致服务无法被正确调用。

  3. Node.js版本管理冲突
    若使用nvm等工具管理多版本Node.js,可能因路径未指向正确版本而报错。

  4. 权限问题
    部分操作需要管理员权限,未以管理员身份运行Cursor可能导致配置失败。


完整解决方案

步骤1:全局安装MCP服务包

@modelcontextprotocol/server-sequential-thinking为例,在命令行中执行以下命令:

npm install -g @modelcontextprotocol/server-sequential-thinking

安装完成后,确认全局包路径:

npm config get prefix

输出示例:

C:\Users\<用户名>\AppData\Roaming\npm

步骤2:使用全路径运行MCP服务

避免依赖npx命令,直接通过Node.js执行服务文件:

node C:\Users\<用户名>\AppData\Roaming\npm\node_modules\@modelcontextprotocol\server-sequential-thinking\dist\index.js

<用户名>替换为您的Windows账户名。若服务成功启动,命令行会显示运行日志。


步骤3:配置Cursor的MCP服务器

  1. 打开Cursor,进入 Settings > Features > MCP Servers

  2. 点击 + Add new MCP server,填写以下信息:

    • Name: Sequential Thinking(自定义名称)

    • Type: Command

    • Command:
      C:\nvm4w\nodejs\node.exe C:\Users\<用户名>\AppData\Roaming\npm\node_modules\@modelcontextprotocol\server-sequential-thinking\dist\index.js
      
    • 若使用nvm管理Node.js,需指定Node.js的完整路径(如C:\nvm4w\nodejs\node.exe)。

  3. 保存配置并重启Cursor。


步骤4:验证服务状态

  1. 返回 MCP Servers 页面,检查服务状态是否为绿色(正常运行)。

  2. 测试工具功能:
    • Sequential Thinking:调用分步思维工具,验证是否能返回结果。

    • Fetch:尝试抓取网页内容,确认返回数据是否完整。

    • Playwright:执行浏览器自动化操作(如截图、表单填写),观察是否报错。


常见问题处理

  1. 权限不足

    • 以管理员身份运行命令行和Cursor。

    • 若安装包时提示权限错误,添加--user参数:
      npm install -g @modelcontextprotocol/server-sequential-thinking --user
      
  2. 路径分隔符问题

    • Windows路径需使用反斜杠\,但在JSON配置中需转义为双反斜杠\\

    • 示例:C:\\Users\\<用户名>\\...

  3. WSL2环境兼容性

    • 若在WSL2中运行Cursor,需确保MCP服务在Windows主机侧启动,并配置端口映射。

    • 建议直接使用原生Windows环境以避免复杂配置。


总结

通过全局安装MCP服务、使用全路径运行、正确配置Cursor的MCP服务器,可解决大多数“Not connected”报错问题。若仍遇到异常,可尝试以下操作:

  1. 检查防火墙设置,确保本地端口未被拦截。

  2. 更新Cursor至最新版本(如v0.46+),支持.cursor/mcp.json配置文件。

  3. 查阅MCP服务官方文档(如GitHub仓库)获取额外依赖或编译指南。


如果以上都不行,可以试试这句话:

我需要帮助用户在Windows系统上安装并运行MCP (Model Context Protocol) 服务,特别是@modelcontextprotocol/server-sequential-thinking这个包。根据用户提供的信息,我需要:全局安装@modelcontextprotocol/server-sequential-thinking包使用全路径运行这个服务,而不是用npx

然后,把github丢给它就行。(cline可这么搞)

最后出现的js配置:

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": [
        "C:\\Users\\Lenovo\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-github\\dist\\index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "XXXXX"
      },
      "disabled": false,
      "autoApprove": [
        "search_repositories"
      ]
    }
  }
}