在使用Cursor的MCP(Model Context Protocol)工具时,许多Windows用户会遇到“Error executing MCP tool: Not connected”的报错。这一问题通常由MCP服务未正确配置或路径问题导致。本文将基于实际案例,提供一套完整的解决方案,帮助您快速修复连接错误。
问题原因分析
以下原因可能导致MCP工具无法连接:
-
MCP服务未安装或未运行
Cursor依赖本地运行的MCP服务,若服务未启动,工具调用会失败。 -
路径配置错误
Windows环境下,使用npx
命令或相对路径可能因环境变量问题导致服务无法被正确调用。 -
Node.js版本管理冲突
若使用nvm等工具管理多版本Node.js,可能因路径未指向正确版本而报错。 -
权限问题
部分操作需要管理员权限,未以管理员身份运行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服务器
-
打开Cursor,进入 Settings > Features > MCP Servers。
-
点击 + 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
)。
-
-
保存配置并重启Cursor。
步骤4:验证服务状态
-
返回 MCP Servers 页面,检查服务状态是否为绿色(正常运行)。
- 测试工具功能:
-
Sequential Thinking:调用分步思维工具,验证是否能返回结果。
-
Fetch:尝试抓取网页内容,确认返回数据是否完整。
-
Playwright:执行浏览器自动化操作(如截图、表单填写),观察是否报错。
-
常见问题处理
-
权限不足
-
以管理员身份运行命令行和Cursor。
- 若安装包时提示权限错误,添加
--user
参数:npm install -g @modelcontextprotocol/server-sequential-thinking --user
-
-
路径分隔符问题
-
Windows路径需使用反斜杠
\
,但在JSON配置中需转义为双反斜杠\\
。 -
示例:
C:\\Users\\<用户名>\\...
-
-
WSL2环境兼容性
-
若在WSL2中运行Cursor,需确保MCP服务在Windows主机侧启动,并配置端口映射。
-
建议直接使用原生Windows环境以避免复杂配置。
-
总结
通过全局安装MCP服务、使用全路径运行、正确配置Cursor的MCP服务器,可解决大多数“Not connected”报错问题。若仍遇到异常,可尝试以下操作:
-
检查防火墙设置,确保本地端口未被拦截。
-
更新Cursor至最新版本(如v0.46+),支持
.cursor/mcp.json
配置文件。 -
查阅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"
]
}
}
}