模型整合-cherry studio+mysql_mcp_server服务配置
一、什么是MCPMCP（Model Context
Protocol）是模型上下文协议，它允许大型语言模型（LLM）通过协议与外部工具或服务交互，动态获取实时数据或执行操纵。简朴来说，它让模型不再局限于静态知识库，而是能像人类一样调用搜索引擎、访问当地文件、毗连API服务，乃至操纵第三方软件。这种能力在必要实时信息（如气候、新闻）或复杂使命（如数据分析）的场景中至关重要。
二、MCP架构介绍
2.1 焦点概念
MCP 遵照客户端-服务器架构（client-server），其中包罗以下几个焦点概念：
[*]MCP 主机（MCP Hosts）：发起请求的 LLM 应用步伐（比方 Claude Desktop、IDE 或 AI 工具）。
[*]MCP 客户端（MCP Clients）：在主机步伐内部，与 MCP server 保持 1:1 的毗连。
[*]MCP 服务器（MCP Servers）：为 MCP client 提供上下文、工具和 prompt 信息。
[*]当地资源（Local Resources）：当地盘算机中可供 MCP server 安全访问的资源（比方文件、数据库）。
[*]长途资源（Remote Resources）：MCP server 可以毗连到的长途资源（比方通过 API）
2.2 MCP Client
MCP client 充当 LLM 和 MCP server 之间的桥梁，MCP client 的工作流程如下：
[*]MCP client 起首从 MCP server 获取可用的工具列表。
[*]将用户的查询连同工具描述通过 function calling 一起发送给 LLM。
[*]LLM 决定是否必要使用工具以及使用哪些工具。
[*]假如必要使用工具，MCP client 会通过 MCP server 执行相应的工具调用。
[*]工具调用的效果会被发送回 LLM。
[*]LLM 基于所有信息生成自然语言响应。
[*]最后将响应展示给用户。
[*]我们可以在：https://modelcontextprotocol.io/clients，找到当前支持 MCP 协议的客户端步伐。
2.3 MCP Server
MCP server 是 MCP 架构中的关键组件，它可以提供 3 种重要范例的功能：
[*]资源（Resources）：雷同文件的数据，可以被客户端读取，如 API 响应或文件内容。
[*]工具（Tools）：可以被 LLM 调用的函数（必要用户批准）。
[*]提示（Prompts）：预先编写的模板，帮助用户完成特定使命。
[*]这些功能使 MCP server 可以大概为 AI 应用提供丰富的上下文信息和操纵能力，从而加强 LLM 的实用性和灵活性。
[*]我们可以在https://github.com/modelcontextprotocol/servers 和 https://github.com/punkpeye/awesome-mcp-servers 这两个 repo 中找到许多由社区实现的 MCP server。使用 TypeScript 编写的 MCP server 可以通过 npx 命令来运行，使用 Python 编写的 MCP server 可以通过 uvx 命令来运行。
2.4 应用架构图
https://i-blog.csdnimg.cn/direct/4fa6cd1cbceb40129068be1a8d3febde.png
三、cherry studio的mcp服务配置
3.1 MCP的两种模式
1）STDIO模式（当地运行）
[*]特点：当地安装运行MCP Server，但需配置开发环境。
[*]配置步骤：
[*]安装依靠：需Python（推荐用uv安装）和NodeJS（推荐bun代替npm），Windows/MacOS/Linux均支持
[*]添加MCP服务：在Cherry Studio->Settings->MCP Servers中，选择Edit JSON，填写mcpServers配置内容。
2）SSE模式（长途服务）
[*]特点：无需当地环境，仅需输入服务器URL，得当调用云端API（如气候查询、数据库接口）。
[*]配置步骤：直接输入SSE服务地址即可，比方集成Google Gemini或腾讯混元的联网搜索功能。
3.2 当地模式的配置操纵指南
1. python和node环境的验证
C:\Users\12487>node -v
v20.12.2
C:\Users\12487>python --version
Python 3.13.2
2. Cherry studio版本要求
建议使用最新版本，旧的版本中，配置项里没有MCP服务的配置
3. 安装MySQL_MCP_Server服务
[*]创建mysql_mcp_server安装路径
mkdir D:\applications\mcp_servers\
[*]git拉取mysql_mcp_server服务： git clone
https://github.com/designcomputer/mysql_mcp_server.git
12487@Lee MINGW64 /d/applications/mcp_servers/mysql_mcp_server
$ git clone https://github.com/designcomputer/mysql_mcp_server.git
Cloning into 'mysql_mcp_server'...
remote: Enumerating objects: 81, done.
remote: Counting objects: 100% (81/81), done.
remote: Compressing objects: 100% (57/57), done.
remote: Total 81 (delta 27), reused 68 (delta 14), pack-reused 0 (from 0)
Receiving objects: 100% (81/81), 16.17 KiB | 172.00 KiB/s, done.
Resolving deltas: 100% (27/27), done.
[*]安装依靠文件：pip install -r requirements.txt
PS D:\applications\mcp_servers\mysql_mcp_server> pip install -r requirements.txt
Collecting mcp>=1.0.0 (from -r requirements.txt (line 1))
Downloading mcp-1.4.1-py3-none-any.whl.metadata (18 kB)
4. uv的配置和安装
[*]执行命令：pip install uv
C:\Users\12487>pip install uv
Collecting uv
WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLEOFError(8, ' EOF occurred in violation of protocol (_ssl.c:1028)'))': /packages/72/18/84ff5e0e940d18d7367fdd57bdba83ea131f1c3771f256faca1099e93690/uv-0.6.9-py3-none-win_amd64.whl.metadata
Downloading uv-0.6.9-py3-none-win_amd64.whl.metadata (11 kB)
Downloading uv-0.6.9-py3-none-win_amd64.whl (17.4 MB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 17.4/17.4 MB 21.9 MB/s eta 0:00:00
Installing collected packages: uv
Successfully installed uv-0.6.9
[*]验证uv环境：uv --version
C:\Users\12487>uv --version
uv 0.6.9 (3d9460278 2025-03-20)
[*]查察uv安装路径：where uv
C:\Users\12487>where uv
D:\applications\python3.13\Scripts\uv.exe
5. MySQL_MCP_Server激活
[*] 配置相关参数：Cherry Studio->设置->MCP服务器中，选择Edit JSON，填写下面内容，步骤如图所示。
{
“mcpServers”: {
“mysql”: {
“isActive”: true,
“command”: “D:/applications/python3.13/Scripts/uv”,
“args”: [
“–directory”,
“D:/applications/mcp_servers/mysql_mcp_server”,
“run”,
“mysql_mcp_server”
],
“env”: {
“MYSQL_HOST”: “localhost”,
“MYSQL_PORT”: “3306”,
“MYSQL_USER”: “root”,
“MYSQL_PASSWORD”: “123456”,
“MYSQL_DATABASE”: “test_db”
}
}
}
}
https://i-blog.csdnimg.cn/direct/511dbbda21734c3a9237446c48c65e0e.png
[*] mysql_mcp_server服务的启用，如上图示。
6. 相关模型参数配置
模型要使用MCP功能，这个模型必要拥有并开启tools功能，然后，在输入框输入查询诉求就可以了。具体操纵如下。
[*] 配置路径为：设置–>模型服务–>ollama–>qwen2.5:7b(我这里选用的是qwen2.5:7b模型)，具体操纵如下图示：
https://i-blog.csdnimg.cn/direct/31ecab0e64614a1e93d7ca2d941955fe.png
[*] 配置成功后有个小扳手的图标，如下图示：
https://i-blog.csdnimg.cn/direct/a1064e5831d947c4b201b7f7e4227d76.png
[*]当地助手使用
[*] 选择助手（这里我用的是自己创建的当地助手）–>选择qwen2.5:7b模型（ollama安装的当地模型）–>选择mcp服务,具体操纵如图所示：
https://i-blog.csdnimg.cn/direct/eba07ee56dda43bf8c2dd4abc5458026.png
[*] 应用示例
https://i-blog.csdnimg.cn/direct/9d4daea7a0244809ba97570c704fcf4f.png
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
页:
[1]