【MCP 应用】CherryStudio 配置和应用 MCP

【DeepSeek应用】Deepseek R1 本地部署(Ollama+Docker+OpenWebUI)
【DeepSeek应用】DeepSeek 搭建个人知识库(Ollama+CherryStudio)



本系列 Deepseek R1 本地部署(Ollama+Docker+OpenWebUI) 介绍了本地部署 Deepseek 大模型、DeepSeek 搭建个人知识库(Ollama+CherryStudio) 介绍了搭建个人知识库
本文进一步介绍 基于 CherryStudio 实现 AI 自动化工作流的步骤,并通过实例代码演示。


在这里插入图片描述

1. 什么是 MCP?

什么是 MCP?

MCP (Model Context Protocol,模型上下文协议) 是大模型应用服务的标准接口协议,旨在以标准化的方式建立 AI 模型和开发环境之间的上下文交互。通过 MCP 可以调用和操作第三方工具,将本地文件系统、浏览器、数据库等资源接入到大语言模型中,与外部世界互动,实现任务自动化,为大模型提供更多的扩展能力,如本地文件的访问、网页信息的获取、地图、天气、搜索等各种功能。

与 传统的 Function Tool(函数工具)相比,Function Tool 也可以为 LLM 提供外部功能,但仍然是针对具体任务的工具,而 MCP 则提供了一种更通用的、模块化的上下文获取机制。

MCP 的核心优势是:

  • 标准化: MCP 提供了统一的接口和数据格式,使得不同的 LLM 和上下文提供者可以无缝协作。
  • 模块化: MCP 允许开发者将上下文信息分解为独立的模块(插件),方便管理和复用。
  • 灵活性: LLM 可以根据自身需求动态选择所需的上下文插件,实现更智能、更个性化的交互。
  • 可扩展性: MCP 的设计支持未来添加更多类型的上下文插件,为 LLM 的能力拓展提供了无限可能

Cherry Studio + MCP

CherryStudio(https://cherry-ai.com) 是一款集多模型对话、知识库管理、AI 绘画、翻译等功能于一体的全能 AI 助手平台。CherryStudio 支持全本地场景使用,可以实现本地部署 Deepseek 的模型调用。近期,Cherry Studio 已开始支持 MCP 服务。

本文以 Cherry Studio 官方文档中提供的 fetch 工具为例,帮助用户快速理解并上手 MCP,并演示如何使用 filesystem 工具操作文件夹,实现通过对话控制桌面文件。

Cherry Studio + MCP 能够帮助用户解决以下问题:

  • 信息获取:实时搜索最新资讯、研究论文、技术文档;
  • 数据分析:连接数据库,执行复杂查询并生成可视化报告;
  • 文档处理:自动整理文件、提取文档关键信息、批量处理文本;
  • 代码辅助:分析项目代码、提供优化建议、自动生成测试用例;
  • 内容创作:结合最新数据创建报告、文章、演示文稿。

除了 Cherry studio 之外,还可以通过 Claude 客户端、Cursor、Cline 插件等工具调用 MCP 工具。


2. CherryStudio + Deepseek API 的安装与配置

2.1 CherryStudio 下载与安装

CherryStudio(https://cherry-ai.com) 是一款集多模型对话、知识库管理、AI 绘画、翻译等功能于一体的全能 AI 助手平台。CherryStudio 支持全本地场景使用,可以实现本地部署 Deepseek 的模型调用。

  1. 下载 CherryStudio 安装程序。
    可以从 CherryStudio 官方网站 下载 CherryStudio 安装程序。如果下载速度慢,可以从官网主页选择“其他版本或备用线路下载”,或网盘下载。

  2. 运行 CherryStudio 安装程序,一路确认即可。

  3. 打开 CherryStudio 应用程序,使用界面如下。关于 CherryStudio 的使用方法,详见【DeepSeek应用】DeepSeek 搭建个人知识库(Ollama+CherryStudio),在此不再赘述。
    在这里插入图片描述


2.2 获取 API 权限

在 CherryStudio 中通过 API 接口调用 GPT、DeepSeek 等模型,需要 API 权限。硅基流动平台提供了 DeepSeek 模型的接入服务,适合需要稳定性和多样化模型的用户。使用邀请码 cXfb9wOT 注册 硅基流动平台,获赠 2000 万 Tokens!

  1. 访问 硅基流动平台,使用邀请码 SM5lc4SJ 注册。如果不使用邀请码也可以注册,但不会获赠 Tokens,您可以在 “余额充值” 中充值获取 Tokens。

  2. 获取API
    API密钥 是您访问 SiliconCloud 接口的凭证,具有该账户的完整权限。
    (1)新建 API 密钥:在左侧控制台中选择 “API秘钥”,进入 API 管理页面,点击右上角的 “新建 API 密钥”,点击 “新建密钥” 即可新建一条 API密钥。

在这里插入图片描述

(2)复制 API 密钥:如下图所示,在 API 管理页面生成了一条 API 密钥,点击秘钥就可以复制 API 密钥,用于通过 API 来调用 Deepseek 模型。

在这里插入图片描述


2.3 CherryStudio 模型配置

  1. 输入 API 密钥:
    打开 CherryStudio 应用程序,点击左下角 “设置” 按钮,选择 “模型服务–硅基流动” 接入模型配置页面,将刚才从 硅基流动 获取的密钥 复制到 右侧的 “API 密钥” 栏中。

在这里插入图片描述

  1. 添加 Deepseek模型:
    详见 【DeepSeek 搭建个人知识库(Ollama+CherryStudio)】 介绍了搭建个人知识库。

  2. 检测 Deepseek 模型的连接:
    详见 【DeepSeek 搭建个人知识库(Ollama+CherryStudio)】 介绍了搭建个人知识库。

  3. 配置嵌入模型:
    详见 【DeepSeek 搭建个人知识库(Ollama+CherryStudio)】 介绍了搭建个人知识库。


3. Cherry Studio 配置 MCP

3.1 MCP 环境安装

  1. 安装依赖:uv、Bun
    (1)打开 Cherry Studio 设置,选择 “MCP服务器”。
    (2)如果显示 “UV缺失”、“Bun缺失”,点击该行的“安装”按钮即可自动下载并安装。安装完成后,显示为 “UV Installed”、“Bun Installed”。

注意:
(1)uv 是一个快速的 Python 包安装和依赖解析器。Bun 是一个用于运行JavaScript和TypeScript应用程序的集成工具包。
(2)Cherry Studio 目前只使用内置的 uv 和 bun,不会复用系统中已经安装的 uv 和 bun。因此,即使之前已安装过这两个工具,仍需在此处通过 Cherry Studio 进行安装。
(3)Cherry Studio 从GitHub 拉取安装包。如果速度过慢,可以手动下载文件 bun-windows-x64.zipuv-x86_64-pc-windows-msvc.zip,复制到安装目录 C:\Users\用户名\.cherrystudio\bin 下 。


在这里插入图片描述

在这里插入图片描述

在这里插入图片描述


3.2 配置 fetch Server

本节以 Cherry Studio 官方文档中提供的 fetch 工具为例介绍 MCP 的配置和使用方法。fetch 数据抓取工具能够实时抓取网页信息,可以显著增强其在数据获取、信息整合和自动化处理方面的能力。

  1. 打开 Cherry Studio 设置,选择 “MCP服务器”。

  2. 点击 “添加服务器”。填入 MCP Server 的相关参数(参考Github-fetch)。
    可能需要填写的内容包括:

    • 名称:自定义名称,例如 “fetch-server”;
    • 类型:选择标准输入/输出 “STDIO”,在本地运行,可访问本机文件和应用程序;
    • 命令:填写 “uvx”
    • 参数:填写 “mcp-server-fetch”
      可能还有其他参数,视具体 Server 而定。
  3. 点击“确定”保存。
    Cherry Studio 会自动下载所需的 MCP Server - fetch server。
    注意:如果 mcp-server-fetch配置不成功,可以尝试重启电脑。


在这里插入图片描述


  1. 启用 MCP 服务器。
    在对话框界面下方,点击启用 MCP 服务器(下图中红色方框位置),选择支持 MCP 的模型(fetch-server)。

在这里插入图片描述


  1. 使用 fetch-server。
    启用 fetch-server 后,提问要求查询网页并返回网页内容。
    如下图所示,未开启 fetch 时无法直接访问外部链接,开启 fetch 后可以成功抓取对应的网页内容。

在这里插入图片描述

至此,我们就完成了一个网页搜索 MCP 的安装、配置和应用。


4. 配置 MCP 的三种方式

Cherry Studio 提供了三种方式添加 MCP 服务:搜索MCP,编辑MCP配置,更多MCP。


4.1 搜索MCP

  1. 点击 MCP 服务器设置页面右上菜单栏相应按钮(下图红色方框位置)即可进入“搜索 MCP”。
  2. 该页面列出了内置的 MCP 服务,可以直接点击 “+” 号(下图红色方框位置)添加。
  3. 添加完成后原来的 “+” 号变成绿色的 “√”,说明这个MCP服务添加成功。
  4. 启用 MCP 服务器的方法同上:在对话框界面下方,点击启用 MCP 服务器,再具体选择启用的 MCP 模型。

在这里插入图片描述


4.2 编辑MCP—新手慎用

在 GitHub 的 MCP Server 项目中汇总了各种用途、可直接使用的 MCP Server。与 Claude Desktop 的配置类似,从 Github-MCP Server 获取 Json 配置文件,直接编辑修改 Cherry Studio 的 Json 文件,也可以完成 MCP 配置。

  1. 从 GitHub 的 MCP Server 搜索寻找相应的 MCP 服务。

在这里插入图片描述


  1. 点击进入相应的 MCP Server,如 “Fetch”,从 “readme.md” 中复制 uvx 安装的 json 代码。

在这里插入图片描述

  1. 在 Cherry Studio MCP 服务器设置页面,点击右上菜单栏 “编辑 MCP 配置”,进入 “编辑 JSON”,如下图所示。按照从 MCP 项目中复制的 uvx 安装 json 代码,修改 “编辑 JSON” 中的 json 文件。——新手慎用,或先将当前的 json 文件另存,便于恢复。

在这里插入图片描述


4.3 更多MCP

mcp.so 网站中汇总了各种常用的 mcp 服务,如地图服务(高德地图)、网页服务(Playwright)和 搜索服务(Tavily)。

  1. 在 Cherry Studio MCP 服务器设置页面,点击右上菜单栏 “更多 MCP”,自动跳转 mcp.so 网站,搜索所需的 mcp 服务,点击进入该 mcp 服务页面。

在这里插入图片描述


  1. 从 mcp.so 搜索寻找 MCP 服务,点击相应卡片框进入相应的 MCP 页面,复制 “Content” 中的 mcpServers 配置信息。
    下面以高德地图 mcp 为例说明。

在这里插入图片描述

在这里插入图片描述


  1. 部分 MCP Server 服务需要 API Key 支持,需要先注册并申请 key。
    使用高德地图服务需要先申请 Key,方法详见:高德开放平台-创建应用和 Key

在这里插入图片描述

在这里插入图片描述


  1. 按照 “Content” 中的 mcpServers 配置信息,填入 MCP Server 的相关参数。其中 “您在高德官网上申请的key” 替换为 用户的高德地图 key(6e0595784******0683a)。
    可能需要填写的内容包括:
    • 名称:自定义名称,例如 “amap-maps”;
    • 类型:选择标准输入/输出 “STDIO”,可以本地运行,访问本机文件和应用程序;
    • 命令:填写 “npx”
    • 参数:填写 “-y”,“@amap/amap-maps-mcp-server”
    • 环境变量:填写:“AMAP_MAPS_API_KEY = 6e0595784******0683a”
      可能还有其他参数,视具体 Server 而定。
{
    "mcpServers": {
        "amap-maps": {
            "command": "npx",
            "args": [
                "-y",
                "@amap/amap-maps-mcp-server"
            ],
            "env": {
                "AMAP_MAPS_API_KEY": 6e0595784******0683a
            }
        }
    }
}

在这里插入图片描述


  1. 启用 MCP 服务器的方法同上:在对话框界面下方,点击启用 MCP 服务器,再具体选择启用的 MCP 模型 amap-maps 后才支持调用MCP服务。

在这里插入图片描述

在这里插入图片描述


版权声明:
youcans@qq.com 原创作品,转载必须标注原文链接:
【DeepSeek应用】DeepSeek 自动化工作流(CherryStudio +MCP)
Copyright@youcans 2025
Crated:2025-04

在这里插入图片描述

### 如何在本地搭建 MCP Server 并连接到 Cherry Studio 要在本地环境中成功搭建 MCP (Model Context Protocol) Server 并将其接入 Cherry Studio,可以按照以下方式操作: #### 1. 安装 Python 必要的依赖项 为了运行 MCP Server,首先需要安装 Python 环境以及相关的库。Python 是一种广泛使用的编程语言,在此场景下用于实现服务器逻辑。 确保已安装最新版本的 Python,并通过 pip 命令安装所需的包: ```bash pip install flask requests model-context-protocol ``` 上述命令会安装 Flask Web 框架以及其他可能需要用到的支持库[^2]。 #### 2. 配置 MCP Server 基于文档中的指导,可以通过简单的脚本快速构建一个基本的功能性 MCP Server。下面是一个基础示例代码片段,展示如何设置并启动一个 MCP Server 实例: ```python from flask import Flask, request, jsonify app = Flask(__name__) @app.route('/mcp', methods=['POST']) def handle_mcp_request(): data = request.json # 处理传入的数据... response_data = {"status": "success", "message": f"Received {data}"} return jsonify(response_data) if __name__ == '__main__': app.run(host='0.0.0.0', port=8080) ``` 这段代码定义了一个 HTTP POST 接口 `/mcp` 来接收来自客户端的消息请求,并返回处理后的响应数据。可以根据实际需求扩展该接口功能来满足更复杂的应用场景。 #### 3. 连接到 Cherry Studio 完成 MCP Server 的部署之后,下一步就是让其能够被 Cherry Studio 所识别访问。这通常涉及到修改应用程序内的配置文件或者界面选项以指定目标地址服务端口号等参数[^1]。 具体来说,打开 Cherry Studio 软件后寻找有关外部服务集成的部分;在此处输入刚才所设定好的 localhost URL 地址(例如 `http://localhost:8080/mcp`),保存更改即可尝试建立初步联系测试连通状态是否正常。 如果一切顺利的话,则应该可以看到双方之间已经形成了有效的通信链路! ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

youcans_

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值