Cherry Studio配置MCP服务踩过的坑

引言：

    Cherry Studio是使用deepseek等AI模型的一种使用量很大的通用平台，
    MCP服务（Model Context Protocol，模型上下文协议）是AI模型调用fetch(读取网页内容)、filesystem(读取文件内容)等操作工具的通用接口（类似于IT设备的typec通用接口）。
    deepseek等AI模型类似于大脑，有了MCP服务，大脑便可以通过MCP接口调用fetch、filesystem等工具来进行各种操作，发挥更为强大的作用。

    下面，我们将在Windows平台下使用Cherry Studio，基于deepseek模型，以配置fetch、filesystem两个MCP服务为例进行说明。

    视频地址：https://www.bilibili.com/video/BV1kLdqYXEMz/?spm_id_from=333.1387.homepage.video_card.click&vd_source=7c7ae5cc1dbb2453e1eb43950a4264a3

    文档地址：https://www.cnblogs.com/ybmj/p/18823316

1、Cherry Studio的模型配置
（1）注册登录deepseek，依次点击右上角“API 开放平台”>>左侧“API keys”，创建一个API keys
    https://platform.deepseek.com/api_keys

    只能在创建时复制1次
    my-deepseek-t3：sk-xxxx

（2）访问https://cherry-ai.com/download，下载最新版Cherry Studio x64（当前为Cherry-Studio-1.2.2-x64-setup.exe），默认安装即可。选择“仅为我安装”，安装路径如下，WinUser01是用户名，需要根据实际情况修改。
  c:\Users\WinUser01\AppData\Local\Programs\Cherry Studio\

 

（3）打开Cherry Studio，进行以下配置
    A、配置“模型服务”
        依次点击“左下角设置”>>“模型服务”>>“深度求索”，复制粘贴上面创建的deepseek的API keys，并点击“检查”。“检查”通过后，点击右上角的按钮开启该模型。
    B、配置“默认模型”
        依次点击“左下角设置”>>“默认服务”>>选择上面配置好的“Deepseek Chat | 深度求索”

2、Cherry Studio 的 MCP 运行环境安装
    当前版本Cherry Studio的 MCP 环境安装有bug，安装bun、nvx工具只能手动安装（第1个坑），下载地址
    A、下载地址
        https://github.com/astral-sh/uv/releases/download/0.6.14/uv-x86_64-pc-windows-msvc.zip

        （第2个坑）必须在 Assets下面的尾部点击“Show All 26 assets”才能找到:
        https://github.com/oven-sh/bun/releases/download/bun-v1.2.9/bun-windows-x64.zip

    B、若无法下载，可用加速下载 https://ghproxy.net/

    C、安装Cherry Studio时，若选择为当前用户安装，则将上面下载的两个压缩包中的3个文件都拷贝到：
    c:\Users\WinUser01\.cherrystudio\bin\bun.exe
    c:\Users\WinUser01\.cherrystudio\bin\uv.exe
    c:\Users\WinUser01\.cherrystudio\bin\uvx.exe

    WinUser01是用户名，需要根据实际情况修改。子目录不存在则需要手动创建

3、Cherry Studio 的 配置 fetch MCP服务
（1）查找 fetch MCP服务
    打开 https://mcp.so 网站，搜索 fetch，找到其 Content 页面
    https://mcp.so/server/fetch/modelcontextprotocol?tab=content

（2）在Cherry Studio配置MCP服务，配置 json 字符串

{
  "mcpServers": {
    "fetch": {
      "isActive": true,
      "command": "uvx",
      "args": [
        "mcp-server-fetch"
      ],
      "name": "fetch"
    }
  }
}

　　

（3）测试
chat提问：
    该网页有哪些内容：https://www.cnblogs.com/ybmj

chat 返回：
    博客 [patton88 - 博客园](https://www.cnblogs.com/ybmj) 主要包含以下内容：

### 最新文章
1. **Sealos 创建 Devbox 实例后，解决“公网调试地址一直显示:准备中”的问题**
- 日期：2025年4月4日
- 摘要：介绍如何解决 Sealos 平台中 Devbox 实例的公网调试地址显示问题，涉及 Spring Boot 和 MyBatis 开发。

2. **VScode两个版本User Installer和System Installer,建议选择System版本**
- 日期：2025年3月16日
- 摘要：比较 VSCode 的 User Installer 和 System Installer 版本的区别，推荐使用 System 版本。

......

### 导航
......

### 公告
......

如果需要查看某篇文章的详细内容，可以告诉我，我会进一步提取或总结！

4、Cherry Studio 的 配置 filesystem MCP服务
（1）查找 filesystem MCP服务
    打开 https://mcp.so 网站，搜索 filesystem，找到其 Content 页面
    https://mcp.so/server/filesystem/modelcontextprotocol?tab=content

（2）在Cherry Studio配置MCP服务，配置 json 字符串，指定路径时需要注意以下事项：
    A、路径用于授权AI访问权限，
    B、路径可以包含多段用逗号分割的路径，每一段路径只能授权访问该路径下面的文件和子目录（递归）
    C、必须注意路径格式、大小写问题，Windows下面路径分隔符必须是双斜杠，有时会区分大小写（第3个坑）
    D、测试时网速慢时会失败，需要多试几次或者换一个网络连接试试（第4个坑）：
    E、以下是成功的格式

npx OK

{
  "mcpServers": {
    "fetch": {
      "isActive": true,
      "command": "uvx",
      "args": [
        "mcp-server-fetch"
      ],
      "name": "fetch"
    },
    "filesystem": {
      "isActive": true,
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "D:\\Download"
      ],
      "name": "filesystem"
    }
  }
}

（3）test1成功

    chat提问：
D:\Download 包含哪些内容，包含子目录和文件？

    chat 返回：
`D:\Download` 目录包含以下内容：

### 文件：
1. `A00.txt`
2. `b9c5030f06044394bf88921d2428e8d2 (1).png`
3. `b9c5030f06044394bf88921d2428e8d2.png`
4. `bun-windows-x64.zip`
5. `uv-x86_64-pc-windows-msvc (1).zip`
6. `uv-x86_64-pc-windows-msvc.zip`
7. `未确认 166637.crdownload`（可能是未完成的下载文件）
8. `百度一下，你就知道.mhtml`（网页存档文件）

### 子目录：
1. `Temp`（临时文件夹）

如果需要进一步查看 `Temp` 子目录的内容，可以告诉我！

（4）test2失败，目录名称大小写不匹配
    chat提问：
D:\download 包含哪些内容，包含子目录和文件？

    chat 返回：
It seems that the path **D:\download** (with a lowercase "d") is not accessible, while **D:\Download** (with an uppercase "D") is allowed.

Would you like me to check the contents of **D:\Download** instead? Let me know! 😊

（5）test3失败，盘符大小写不匹配
    chat提问：
d:\Download 包含哪些内容，包含子目录和文件？

    chat 返回：
It seems there was an issue accessing the path **d:\Download** (with a lowercase "d"). The system only allows access to **D:\Download** (with an uppercase "D").

Would you like me to check the contents of **D:\Download** instead? Let me know! 😊