Windows下通过Cherry Studio使用MCP的常见问题处理思路

大模型向量数据库NoSQL数据库

关注我~第一时间学习如何更好地使用AI。

重要的不是我们是否会被AI替代,

而是我们要比被替代的人更懂AI。

注意,本文系根据后台粉丝提出的高频问题,由笔者查阅Cherry Studio帮助文档及Github上的issues信息,并针对Windows用户环境整理而成,如有疏漏还望轻喷。

首先需要强调的是,Cherry Studio的帮助文档内容非常详尽,强烈建议大家先把帮助文档看一遍,或许能解锁很多自己并不了解,但其实早就可以实现的新功能~~

picture.image

另外,对于一些具体MCP服务使用过程中出现的模型报错,可以到Cherry Studio的官方MCP错误反馈汇总中查询:

https://github.com/CherryHQ/cherry-studio/issues/3264

接下来,我们来看看Windows系统下通过Cherry Studio使用MCP服务过程中遇到的常见问题的处理方法:

uv、bun无法顺利安装怎么办?

picture.image

根据Cherry Studio帮助文档,由于点击【安装】按钮后,是直接从GitHub上下载相关程序,速度可能会比较慢,甚至很容易失败。

因此,当出现uv、bun安装卡住的情况时,可采取下列步骤应对:

1.去下列目录查看是否有对应的文件

C:\Users\【你的操作系统用户名】\.cherrystudio\bin

注意:对于Windows小白用户,请打开【文件资源管理器】,在左侧的文件目录列表中,按以下路径寻找.cherrystudio文件夹:

【此电脑】-【本地磁盘(C:)】-【用户】-【除了“Default”、“公用”以外的那个,用你自己用户名命名的文件夹】

如果实际uv、bun下载成功了,你应该在.cherrystudio文件夹里的bin中看到以下内容:

picture.image

如果没有看到这些文件,那么继续下一步。

2.手动下载可执行文件放到bin目录下

Windows小白需要注意将页面下滑到Assets部分,点击【Show all XX assets】:

picture.image

然后下载Windows适用的最新版,解压缩到C:\Users\【你的操作系统用户名】\.cherrystudio\bin即可:

picture.image

picture.image

完成之后,重启Cherry Sdutio,应该就OK了。

当然,因为也是从GitHub上下载,大家可以提前优化下网络环境,或者寻找其他下载资源。

MCP服务器配置过程中的报错如何处理?

常见报错

  • 1.MCP Server启动失败报错

picture.image

  • 2.链接失败报错
  • picture.image

解决方案

添加MCP服务器弹出上述错误,通常与npx命令有关。

Cherry Studio的开发者@vaayne提供了macOS下的一些解决方案,参见:

https://github.com/CherryHQ/cherry-studio/issues/3264

之前公众号后台有大佬指出,npm和node工具版本低,也可能是这个问题的罪魁祸首。

因此,下面我将针对Windows系统用户通过,修复 Node.js 环境未正确安装或配置,以及版本不够新的问题,来尝试处理上述报错。(但建议可以按前文所述,先更新一下bun试试):

  • 首先,确认 Node.js 和 npm 是否已安装

npx 是 Node.js 附带的工具,需确保 Node.js 已正确安装。

打开命令提示符(Win + R → 输入 cmd → 回车),输入以下命令,检查版本号:

  
node -v  
npm -v  
npx -v

如果提示“未找到命令”,请移步https://nodejs.org/下载并安装 Node.js。

注意,安装时,务必勾选 “Add to PATH” 选项,以便将 Node.js 添加到环境变量。

  • 2.修复 Node.js 环境变量

即使安装了 Node.js,若未正确添加到环境变量,系统仍无法识别 npx,因此需要:

1)找到 Node.js 的安装路径(默认路径:C:\Program Files\nodejs)。

2)右键“【此电脑】” → 【属性】 → 【高级系统设置】 → 【 环境变量】 → 【系统变量中的 Path】 →【 编辑】。

3)检查是否包含 Node.js 的安装路径(如 C:\Program Files\nodejs)和 npm 的全局路径(如xxx\AppData\Roaming\npm)。

5)如果没有,手动添加路径 → 保存 → 重启电脑。

  • 3.更新 Node.js 和 npm

还有一种可能是Node.js和npm的版本不够,这时需要:

1)访问 Node.js 官网(https://nodejs.org/) 下载最新版本并覆盖安装。

2)打开命令提示符(Win + R → 输入 cmd → 回车),输入以下命令更新npm:

  
npm install -g npm@latest

为什么在聊天框看不到MCP服务的按钮?

首先,你需要确认MCP服务器已经顺利添加。

其次,检查你使用的模型,是否支持工具调用,标志就是模型名称后面是否有个小扳手标记。如果你选择的模型没有小扳手,那MCP服务的按钮就不会显示。

picture.image

好了,以上就是本期的全部内容,祝大家顺利玩上MCP!

—— END——

往期精华:

1.MCP使用

1)Cherry Studio重大版本更新!手把手教你丝滑配置MCP服务器!

2)萌新指南|手把手教你Cherry Studio配置MCP,10分钟让大模型学会上网截图!

3)想玩玩极简版AI Agent?MCP就够了!手把手教你用Cherry Studio整活~

4)MCP x Obsidian:体验智能笔记新境界,Cherry Studio 萌新操作指南

2.Workflow编排

AI工作流编排手把手指南之一:Coze智能体的创建与基本设置

AI工作流编排手把手指南之二:Coze智能体的插件添加与调用

AI工作流编排手把手指南之三:Coze智能体的工作流

3.Prompt设计

打工人看了流泪的Prompt设计原理,如何用老板思维让AI一次听懂需求?

不会Prompt还敢说自己会用DeepSeek?别怕!10分钟让你成为提示大神!

4.AI工具指南

0代码!5分钟,搭建DeepSeek驱动的知识库,小白也能行?!

0
0
0
0
关于作者
关于作者

文章

0

获赞

0

收藏

0

相关资源
大规模高性能计算集群优化实践
随着机器学习的发展,数据量和训练模型都有越来越大的趋势,这对基础设施有了更高的要求,包括硬件、网络架构等。本次分享主要介绍火山引擎支撑大规模高性能计算集群的架构和优化实践。
相关产品
评论
未登录
看完啦,登录分享一下感受吧~
暂无评论