CherryStudio配置本地MCP服务器:实现本地文件读写

摘要：若安装失败（如提示找不到“uvx”或“bun”），需手动从GitHub下载UV和Bun的可执行文件，并放入上述目录。

以下是为Cherry Studio内置的MCP服务器添加FileSystem文件系统MCP组件的详细步骤：

步骤1：安装UV和Bun工具

FileSystem文件系统操作MCP组件的运行依赖UV和Bun工具，需先确保它们已正确安装：

1. 自动安装（推荐）：

打开Cherry Studio，进入【设置】 → 【MCP服务器】。

点击【安装】按钮，工具会自动下载并安装到以下路径：

Windows: “C:\Users\\.cherrystudio\bin”

macOS/Linux: “\~/.cherrystudio/bin”。

2.手工安装（必需）：

若安装失败（如提示找不到“uvx”或“bun”），需手动从GitHub下载UV和Bun的可执行文件，并放入上述目录。

我自己的经验来说，截止目前v1.2.4版本的CherryStudio，在启用内置的“MCP服务器”时，无论是能或者不能直连GitHub下载UV和Bun工具，就算显示安装成功，我去对应文件夹下看过，仍然是没有的，这就是谎报。

所以还是老老实实手工下载对应工具包到对应目录吧。

当然，考虑到国内的网络现状，并且GitHub在4月中旬还封禁了所有中国IP访问，幸好我都已经把bun和uvx这两个包都存放在本地，大家如有需要，可以关注本公众号后，发消息【mcp-filesystem】，以获取国内可用下载链接。

步骤2：添加FileSystem MCP服务器

1. 进入MCP服务器配置界面：

在Cherry Studio中，点击 “设置” → “MCP服务器” → “添加服务器”。

2.通过搜索MCP进行在线安装：

下面是直接在CherryStudio里“MCP服务器”页面顶部点击“搜索MCP”。

在“搜索MCP”页面里面找到想要的MCP服务，点“+”号添加即可：

在搜索框中列举了几家出品MCP服务的分发机构，例如：@cherry；@modelcontextprotocol；@gongrzhe；@mcpmarket这几家，当然cherry应该就是CherryStudio开发商自己搞的，看名字modelcontextprotocol像是哪家MCP官方搞的，还有mcp.so等MCP市场。

添加成功后，记得要对“@cherry/filesystem”添加一下配置：

主要是为“@cherry/filesystem”MCP服务器在“参数”添加可操作的本机文件操作路径：“D:\mcp_on_t11pro”；而且从CherryStudio v1.2.4版本起已经不像网上说的那样“配置Windows的文件系统路径时，必须把单反斜杠（\）替换为双反斜杠（\\）”，目前已经不需要这样了，按正常的路径写即可。

步骤3：验证与使用

1. 保存配置：

点击 “确定” 保存服务器配置，重启Cherry Studio使配置生效。

2. 启用MCP服务：

在聊天界面中，选择支持函数调用的模型（模型名称旁有扳手图标）。

点击输入框下方的 “MCP服务器”，勾选已添加的“@ferry/filesystem”服务。

3. 测试功能：

输入指令测试文件操作，例如：

“使用@cherry/filesystem读取“d:\mcp_on_t11pro\nongye.txt”文件的内容，并显示”

成功返回文件内容，配置完成。