1. Cherry Studio 中配置和使用模型上下文协议（MCP）

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

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

[!info] 阅读导览
第 2 章 准备工作 → 第 3 章 配置环境（STDIO 需要）→ 第 4 章 配置 MCP 服务器 → 第 5 章 使用 MCP → 第 6 章 FAQ（网络问题 / 路径型服务）→ 第 7–8 章 Smithery 与命令找不到的解决办法

flowchart TD
    A[安装最新版 Cherry Studio] --> B{用哪种 MCP 传输？}
    B -->|STDIO 本地| C[配置环境<br>Python uv / Bun / NodeJS]
    B -->|SSE 远程| D[跳过环境配置]
    C --> E[设置 → MCP 服务器<br>添加服务器]
    D --> E
    E --> F[填写 STDIO 命令参数<br>或 SSE URL]
    F --> G[启用所需 MCP 服务]
    G --> H[对话中调用 MCP 工具]

2. 准备工作

2.1. 安装最新版本的 Cherry Studio

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

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/

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

[!success] 核心要点

• 两种传输：STDIO（本地，可访问本机资源，需 Python/NodeJS 环境）与 SSE（远程，只需 URL）
• 环境安装：Windows 用 PowerShell 装 uv / Bun / NodeJS；Mac/Linux 用 Homebrew
• 配置入口：设置 → MCP 服务器 → 添加服务器，STDIO 填命令与参数，SSE 填 URL
• 网络问题：PyPI 用清华等国内镜像（uvx -i），npm 用 npmmirror（--registry）
• 命令找不到：用 which 查绝对路径后填入，或改用 bunx 代替 npx
• 省 Token：MCP 调用会消耗大量 Token，按需启用，建议只开需要的服务