1- Cherry Studio 中配置和使用模型上下文协议 (MCP)

模型上下文协议（Model Context Protocol，简称 MCP）允许大型语言模型（LLM）通过调用外部工具和服务获取实时信息，从而扩展其能力。本文将详细介绍如何在 Cherry Studio 中配置和使用 MCP。

💡 提示：建议提前阅读 MCP 协议完全指南 了解更多 MCP 相关的基础知识。

2- 准备工作

2.1- 1. 安装最新版本的 Cherry Studio

从官方网站 cherry-ai.com 下载并安装最新版的 Cherry Studio。

2.2- 2. 了解 MCP 传输协议类型

MCP 支持两种传输协议：

• STDIO（标准输入/输出）：在本地运行，可访问本机文件和应用程序，但需要配置 Python 和 NodeJS 环境
• SSE（服务器发送事件）：在远程服务器运行，配置简单，但无法访问本地资源

3- 配置环境（STDIO 类型需要）

如果你只使用 SSE 类型的 MCP 服务，可以跳过此部分。

3.1- Windows 环境配置

3.1.1- 安装 Python （使用 uv)

1. 打开 PowerShell

2. 运行安装命令

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

3. 关闭并重新打开 PowerShell，输入 uv 验证安装是否成功

3.1.2- 使用 bun 安装 NodeJS （推荐）

1. 前往 官方网站 复制安装命令，打开 PowerShell 粘贴运行

powershell -c "irm bun.sh/install.ps1|iex"

2. 安装完成后，关闭并重新打开 PowerShell，输入 bun --version 验证安装

3.1.3- 安装 NodeJS

1. 前往 官方网站 下载安装包并运行

2. 安装完成后，打开 PowerShell，输入 node --version 验证安装

3.2- MacOS / Linux 环境配置

1. 安装 Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 使用 Homebrew 安装 uv

brew install uv

3. 使用 Homebrew 安装 Bun

brew install oven-sh/bun/bun

4. 使用 Homebrew 安装 NodeJS

brew install node

5. 在终端分别运行 uv 和 bun 或者 node 验证安装成功

4- 配置 MCP 服务器

在 Cherry Studio 中，通过以下步骤添加 MCP 服务器：

1. 进入 设置 -> MCP 服务器
2. 点击 添加服务器 按钮

4.1- STDIO 类型配置

STDIO 类型的 MCP 服务在本地运行，可以访问本地文件和系统资源。下面以官方 Fetch MCP Server 为例：

1. 点击 添加服务器，选择 STDIO 类型
2. 填写配置信息：

• 名称：fetch（服务器的标识名）
• 命令：uvx（用于运行服务的命令）
• 参数：mcp-server-fetch（命令的参数）

高级配置：某些 MCP 服务需要环境变量，例如 Brave Search MCP Server 需要 API 密钥：

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

对于 npx 有问题的可以使用 bunx 代替，上面的等效于

{
  "mcpServers": {
    "brave-search": {
      "command": "bunx",
      "args": [
        "@modelcontextprotocol/server-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

4.2- SSE 类型配置

SSE 类型的 MCP 服务配置简单，只需提供服务器的 URL。此类型服务在远程服务器上运行，无法访问本地资源。

5- 使用 MCP

确保 MCP 服务已配置并正常运行。在设置页面启用所需的 MCP 服务：

进入聊天界面，点击 MCP 服务器按钮选择要启用的 MCP 服务器：

启用 MCP 服务后，每次操作都会与大模型交互，消耗大量 Token。建议只启用需要的 MCP 服务。

右上角的开关可启用全部 MCP 服务，也可选择单个 MCP 服务。

在对话中启用 fetch 和 tavily-mcp 服务，LLM 会多次调用 MCP 服务获取信息。

点击 MCP 状态栏查看调用参数和返回结果，方便分析结果的可靠性。

6- FAQ

6.1- 如何解决网络问题？

国内网络环境可能导致安装 uv 和 NodeJS 时无法访问外网资源。以下是解决方案：

6.1.1- Python 包使用国内镜像源

使用 -i 参数指定国内镜像源：

uvx -i https://pypi.tuna.tsinghua.edu.cn/simple mcp-server-fetch

常用国内 PyPI 镜像：

- 清华大学：`https://pypi.tuna.tsinghua.edu.cn/simple`
- 阿里云：`http://mirrors.aliyun.com/pypi/simple/`
- 中国科技大学：`https://mirrors.ustc.edu.cn/pypi/simple/`
- 华为云：`https://repo.huaweicloud.com/repository/pypi/simple/`
- 腾讯云：`https://mirrors.cloud.tencent.com/pypi/simple/`

清华大学：

https://pypi.tuna.tsinghua.edu.cn/simple

阿里云：

http://mirrors.aliyun.com/pypi/simple/

中国科技大学：

https://mirrors.ustc.edu.cn/pypi/simple/

华为云：

https://repo.huaweicloud.com/repository/pypi/simple/

腾讯云：

https://mirrors.cloud.tencent.com/pypi/simple/

6.1.2- 配置示例

6.1.3- NodeJS 包使用国内镜像源

使用 --registry 参数指定国内 npm 镜像：

npx --registry=https://registry.npmmirror.com -y @modelcontextprotocol/server-filesystem

6.1.3.1- 常用 npm 镜像

• 淘宝镜像：

https://registry.npmmirror.com

6.2- 带有路径的 MCP 服务怎么安装

某些 MCP 服务未打包到 npm 或 pypi，需要本地运行源代码。

• 先下载代码，安装依赖，再运行。例如：web-search

{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["/path/to/web-search/build/index.js"]
    }
  }
}

7- 如何使用 smithery 安装

目前不支持使用 smithery 进行安装。smithery 自动写入配置文件，但我们暂不支持此方式。

8- 找不到 npx 或者 uvx 命令

如果设置 MCP 服务器时提示找不到 npx 或 uvx 命令，请使用绝对路径，例如：

`bunx` 换成 `/opt/homebrew/bin/bunx` 

或者 

`uvx` 换成 `/opt/homebrew/bin/uvx`

具体路径可以使用 which 命令查看：

> which bunx
> 
/opt/homebrew/bin/bunx