【MCP 应用】CherryStudio 配置和应用 MCP
【DeepSeek应用】Deepseek R1 本地部署(Ollama+Docker+OpenWebUI)
【DeepSeek应用】DeepSeek 搭建个人知识库(Ollama+CherryStudio)
智能体(CherryStudio +MCP)
- 1. 什么是 MCP?
- 2. CherryStudio + Deepseek API 的安装与配置
- 2.1 CherryStudio 下载与安装
- 2.2 获取 API 权限
- 2.3 CherryStudio 模型配置
- 3. Cherry Studio 配置 MCP
- 3.1 MCP 环境安装
- 3.2 配置 fetch Server
- 4. 配置 MCP 的三种方式
- 4.1 搜索MCP
- 4.2 编辑MCP—新手慎用
- 4.3 更多MCP
本系列 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 的模型调用。
-
下载 CherryStudio 安装程序。
可以从 CherryStudio 官方网站 下载 CherryStudio 安装程序。如果下载速度慢,可以从官网主页选择“其他版本或备用线路下载”,或网盘下载。 -
运行 CherryStudio 安装程序,一路确认即可。
-
打开 CherryStudio 应用程序,使用界面如下。关于 CherryStudio 的使用方法,详见【DeepSeek应用】DeepSeek 搭建个人知识库(Ollama+CherryStudio),在此不再赘述。
2.2 获取 API 权限
在 CherryStudio 中通过 API 接口调用 GPT、DeepSeek 等模型,需要 API 权限。硅基流动平台提供了 DeepSeek 模型的接入服务,适合需要稳定性和多样化模型的用户。使用邀请码 cXfb9wOT 注册 硅基流动平台,获赠 2000 万 Tokens!
-
访问 硅基流动平台,使用邀请码 SM5lc4SJ 注册。如果不使用邀请码也可以注册,但不会获赠 Tokens,您可以在 “余额充值” 中充值获取 Tokens。
-
获取API
API密钥 是您访问 SiliconCloud 接口的凭证,具有该账户的完整权限。
(1)新建 API 密钥:在左侧控制台中选择 “API秘钥”,进入 API 管理页面,点击右上角的 “新建 API 密钥”,点击 “新建密钥” 即可新建一条 API密钥。
(2)复制 API 密钥:如下图所示,在 API 管理页面生成了一条 API 密钥,点击秘钥就可以复制 API 密钥,用于通过 API 来调用 Deepseek 模型。
2.3 CherryStudio 模型配置
- 输入 API 密钥:
打开 CherryStudio 应用程序,点击左下角 “设置” 按钮,选择 “模型服务–硅基流动” 接入模型配置页面,将刚才从 硅基流动 获取的密钥 复制到 右侧的 “API 密钥” 栏中。
-
添加 Deepseek模型:
详见 【DeepSeek 搭建个人知识库(Ollama+CherryStudio)】 介绍了搭建个人知识库。 -
检测 Deepseek 模型的连接:
详见 【DeepSeek 搭建个人知识库(Ollama+CherryStudio)】 介绍了搭建个人知识库。 -
配置嵌入模型:
详见 【DeepSeek 搭建个人知识库(Ollama+CherryStudio)】 介绍了搭建个人知识库。
3. Cherry Studio 配置 MCP
3.1 MCP 环境安装
- 安装依赖: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.zip 和 uv-x86_64-pc-windows-msvc.zip,复制到安装目录 C:\Users\用户名\.cherrystudio\bin
下 。
3.2 配置 fetch Server
本节以 Cherry Studio 官方文档中提供的 fetch 工具为例介绍 MCP 的配置和使用方法。fetch 数据抓取工具能够实时抓取网页信息,可以显著增强其在数据获取、信息整合和自动化处理方面的能力。
-
打开 Cherry Studio 设置,选择 “MCP服务器”。
-
点击 “添加服务器”。填入 MCP Server 的相关参数(参考Github-fetch)。
可能需要填写的内容包括:- 名称:自定义名称,例如 “fetch-server”;
- 类型:选择标准输入/输出 “STDIO”,在本地运行,可访问本机文件和应用程序;
- 命令:填写 “uvx”
- 参数:填写 “mcp-server-fetch”
可能还有其他参数,视具体 Server 而定。
-
点击“确定”保存。
Cherry Studio 会自动下载所需的 MCP Server - fetch server。
注意:如果 mcp-server-fetch配置不成功,可以尝试重启电脑。
- 启用 MCP 服务器。
在对话框界面下方,点击启用 MCP 服务器(下图中红色方框位置),选择支持 MCP 的模型(fetch-server)。
- 使用 fetch-server。
启用 fetch-server 后,提问要求查询网页并返回网页内容。
如下图所示,未开启 fetch 时无法直接访问外部链接,开启 fetch 后可以成功抓取对应的网页内容。
至此,我们就完成了一个网页搜索 MCP 的安装、配置和应用。
4. 配置 MCP 的三种方式
Cherry Studio 提供了三种方式添加 MCP 服务:搜索MCP,编辑MCP配置,更多MCP。
4.1 搜索MCP
- 点击 MCP 服务器设置页面右上菜单栏相应按钮(下图红色方框位置)即可进入“搜索 MCP”。
- 该页面列出了内置的 MCP 服务,可以直接点击 “+” 号(下图红色方框位置)添加。
- 添加完成后原来的 “+” 号变成绿色的 “√”,说明这个MCP服务添加成功。
- 启用 MCP 服务器的方法同上:在对话框界面下方,点击启用 MCP 服务器,再具体选择启用的 MCP 模型。
4.2 编辑MCP—新手慎用
在 GitHub 的 MCP Server 项目中汇总了各种用途、可直接使用的 MCP Server。与 Claude Desktop 的配置类似,从 Github-MCP Server 获取 Json 配置文件,直接编辑修改 Cherry Studio 的 Json 文件,也可以完成 MCP 配置。
- 从 GitHub 的 MCP Server 搜索寻找相应的 MCP 服务。
- 点击进入相应的 MCP Server,如 “Fetch”,从 “readme.md” 中复制 uvx 安装的 json 代码。
- 在 Cherry Studio MCP 服务器设置页面,点击右上菜单栏 “编辑 MCP 配置”,进入 “编辑 JSON”,如下图所示。按照从 MCP 项目中复制的 uvx 安装 json 代码,修改 “编辑 JSON” 中的 json 文件。——新手慎用,或先将当前的 json 文件另存,便于恢复。
4.3 更多MCP
mcp.so 网站中汇总了各种常用的 mcp 服务,如地图服务(高德地图)、网页服务(Playwright)和 搜索服务(Tavily)。
- 在 Cherry Studio MCP 服务器设置页面,点击右上菜单栏 “更多 MCP”,自动跳转 mcp.so 网站,搜索所需的 mcp 服务,点击进入该 mcp 服务页面。
- 从 mcp.so 搜索寻找 MCP 服务,点击相应卡片框进入相应的 MCP 页面,复制 “Content” 中的 mcpServers 配置信息。
下面以高德地图 mcp 为例说明。
- 部分 MCP Server 服务需要 API Key 支持,需要先注册并申请 key。
使用高德地图服务需要先申请 Key,方法详见:高德开放平台-创建应用和 Key。
- 按照 “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}}}
}
- 启用 MCP 服务器的方法同上:在对话框界面下方,点击启用 MCP 服务器,再具体选择启用的 MCP 模型 amap-maps 后才支持调用MCP服务。
版权声明:
youcans@qq.com 原创作品,转载必须标注原文链接:
【DeepSeek应用】DeepSeek 自动化工作流(CherryStudio +MCP)
Copyright@youcans 2025
Crated:2025-04