模型整合-cherry studio+mysql_mcp_server服务配置

一、什么是MCP

   MCP（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 应用架构图

三、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环境的验证

1. C:\Users\12487>node -v
2. v20.12.2
4. C:\Users\12487>python --version
5. Python 3.13.2

复制代码

2. Cherry studio版本要求

建议使用最新版本，旧的版本中，配置项里没有MCP服务的配置
3. 安装MySQL_MCP_Server服务

• 创建mysql_mcp_server安装路径
  

1. mkdir D:\applications\mcp_servers\

复制代码

• git拉取mysql_mcp_server服务： git clone
  

1. https://github.com/designcomputer/mysql_mcp_server.git
2. 12487@Lee MINGW64 /d/applications/mcp_servers/mysql_mcp_server
3. $ git clone https://github.com/designcomputer/mysql_mcp_server.git
4. Cloning into 'mysql_mcp_server'...
5. remote: Enumerating objects: 81, done.
6. remote: Counting objects: 100% (81/81), done.
7. remote: Compressing objects: 100% (57/57), done.
8. remote: Total 81 (delta 27), reused 68 (delta 14), pack-reused 0 (from 0)
9. Receiving objects: 100% (81/81), 16.17 KiB | 172.00 KiB/s, done.
10. Resolving deltas: 100% (27/27), done.

复制代码

• 安装依靠文件：pip install -r requirements.txt
  

1. PS D:\applications\mcp_servers\mysql_mcp_server> pip install -r requirements.txt
2. Collecting mcp>=1.0.0 (from -r requirements.txt (line 1))
3.   Downloading mcp-1.4.1-py3-none-any.whl.metadata (18 kB)

复制代码

4. uv的配置和安装

• 执行命令：pip install uv
  

1. C:\Users\12487>pip install uv
2. Collecting uv
3.   WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLEOFError(8, '[SSL: UNEXPECTED_EOF_WHILE_READING] EOF occurred in violation of protocol (_ssl.c:1028)'))': /packages/72/18/84ff5e0e940d18d7367fdd57bdba83ea131f1c3771f256faca1099e93690/uv-0.6.9-py3-none-win_amd64.whl.metadata
4.   Downloading uv-0.6.9-py3-none-win_amd64.whl.metadata (11 kB)
5. Downloading uv-0.6.9-py3-none-win_amd64.whl (17.4 MB)
6.    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 17.4/17.4 MB 21.9 MB/s eta 0:00:00
7. Installing collected packages: uv
8. Successfully installed uv-0.6.9

复制代码

• 验证uv环境：uv --version
  

1.   C:\Users\12487>uv --version
2. uv 0.6.9 (3d9460278 2025-03-20)

复制代码

• 查察uv安装路径：where uv
  

1. C:\Users\12487>where uv
2. 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”
  }
  }
  }
  }
  
  
  
  
• mysql_mcp_server服务的启用，如上图示。
  

6. 相关模型参数配置

模型要使用MCP功能，这个模型必要拥有并开启tools功能，然后，在输入框输入查询诉求就可以了。具体操纵如下。

• 配置路径为：设置–>模型服务–>ollama–>qwen2.5:7b(我这里选用的是qwen2.5:7b模型)，具体操纵如下图示：
  
  
  
  
• 配置成功后有个小扳手的图标，如下图示：
  
  
  
  

• 当地助手使用
  

• 选择助手（这里我用的是自己创建的当地助手）–>选择qwen2.5:7b模型（ollama安装的当地模型）–>选择mcp服务,具体操纵如图所示：
  
  
  
  
• 应用示例
  
  
  
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。