1. 为什么要在 Cherry Studio 里接 MCP 查数据库Cherry Studio 是一款面向国内用户的 AI 助手客户端支持多模型对话、知识库、AI 绘画、翻译等功能同时兼容 OpenAI、Anthropic、Gemini 等主流服务商的接口规范。它最大的特点是聚合——你可以把不同来源的模型统一放在一个界面里调用不用来回切换网页。但光有对话能力还不够。真正让 Cherry Studio 从聊天工具变成生产力工具的是它对 MCPModel Context Protocol模型上下文协议的支持。MCP 允许大语言模型通过标准协议调用外部工具或服务动态获取实时数据或执行操作。换句话说模型不再局限于训练时的静态知识而是能像人一样去查数据库、读文件、调接口。这篇文章要解决的问题很具体如何让 Cherry Studio 通过 MCP 连接一个 MySQL 数据库用自然语言直接查询员工信息。适合两类人——一类是本地开发者想快速验证 MCP 链路是否跑通另一类是数据分析人员希望不写 SQL 就能从数据库里捞数据。整个链路的走向是这样的你在 Cherry Studio 输入框里用中文提问 → 模型判断需要调用工具 → MCP 协议把请求转发给本地的 mysql_mcp_server → 服务端执行 SQL 并返回结果 → 模型整理成自然语言回复你。这里有一个容易被忽略的环节模型本身的推理请求走哪里。如果你用的是本地 Ollama 模型推理在本地完成但如果你想让更强的云端模型来驱动整个流程就需要一个统一的 API 通道。TaoToken 提供的正是这个能力——一个 Key 就能调用多种模型兼容 OpenAI 规范Cherry Studio 里直接填 Base URL 和 Key 就能接入。后面的章节我会把这条链路完整串起来。先明确一下本文的验证目标用 Docker 跑一个 MySQL 8.0 实例导入 MySQL 官方的 Employees 测试数据库约 30 万条员工记录然后通过 mysql_mcp_server 暴露给 Cherry Studio最后用一句帮我查一下 employees 库里有多少张表来验证整条链路是否连通。2. 前置准备MySQL 测试库、mysql_mcp_server 与 TaoToken 接入这一节把三样东西准备好一个能跑的 MySQL 数据库、一个 MCP 服务端、以及一个统一的模型 API 通道。2.1 用 Docker 拉起 MySQL 8.0 并导入 Employees 测试库MySQL 官方提供了一个 Employees 示例数据库包含 employees、departments、salaries、titles 等表数据量适中非常适合做查询验证。先克隆测试数据仓库并创建数据持久化目录和初始化脚本目录git clone https://github.com/datacharmer/test_db.git mkdir -p ~/mysql_demo/data mkdir -p ~/mysql_demo/init cp test_db/employees.sql ~/mysql_demo/init/确认一下文件到位ls -lh ~/mysql_demo/init/ # -rw-r--r-- 1 user staff 4.1K employees.sql然后用 Docker 启动 MySQL把初始化脚本挂载到/docker-entrypoint-initdb.d容器首次启动时会自动执行docker run -d \ --name mysql_test \ -p 3306:3306 \ -e MYSQL_ROOT_PASSWORD123456 \ -v ~/mysql_demo/data:/var/lib/mysql \ -v ~/mysql_demo/init:/docker-entrypoint-initdb.d \ mysql:8.0 \ --character-set-serverutf8mb4 \ --collation-serverutf8mb4_unicode_ci等几秒让初始化完成检查容器状态docker ps # CONTAINER ID IMAGE STATUS PORTS # a1b2c3d4e5f6 mysql:8.0 Up 30 seconds 0.0.0.0:3306-3306/tcp进入容器验证数据库是否导入成功docker exec -it mysql_test mysql -uroot -p123456 -e show databases;你应该能看到employees库出现在列表里。再确认一下表数量docker exec -it mysql_test mysql -uroot -p123456 -e use employees; show tables;正常会返回 departments、dept_emp、dept_manager、employees、salaries、titles 六张表。2.2 安装 mysql_mcp_serverMCP 服务端我选的是 Python 实现的mysql_mcp_server它把 MySQL 的查询能力封装成 MCP 工具模型可以通过标准协议调用。git clone https://github.com/designcomputer/mysql_mcp_server.git cd mysql_mcp_server pip install -r requirements.txt如果你用 uv 管理 Python 环境也可以直接uv run mysql_mcp_server后面配置里我会用 uv 的绝对路径。2.3 在 TaoToken 获取统一 API Key前面说过MCP 负责工具调用但模型推理本身需要一个 API 端点。TaoToken 的好处是一个 Key 打通多种模型兼容 OpenAI 接口规范Cherry Studio 里配置起来很直接。操作路径访问官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite API Key 管理页面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 。拿到 Key 之后记下两个关键信息配置项值Base URLhttps://taotoken.net/apiAPI Key控制台生成的sk-开头的字符串Model ID例如gpt-4o、claude-sonnet-4-20250514等以控制台模型列表为准这三个要素Base URL Key Model ID在后面 Cherry Studio 的模型服务商配置里会全部用到缺一不可。3. 可复制配置Cherry Studio 侧 MCP 与模型服务商设置这一节是全文的核心操作部分所有配置片段都可以直接复制。3.1 在 Cherry Studio 添加 MCP 服务端打开 Cherry Studio进入Settings - MCP Servers点击Edit JSON把下面这段配置粘贴进去{ mcpServers: { mysql: { command: /Users/yourname/.local/bin/uv, args: [ --directory, /Users/yourname/mysql_mcp_server, run, mysql_mcp_server ], env: { MYSQL_HOST: localhost, MYSQL_PORT: 3306, MYSQL_USER: root, MYSQL_PASSWORD: 123456, MYSQL_DATABASE: employees } } } }几个关键点需要替换成你自己的路径command字段填 uv 的绝对路径。用which uv可以查到macOS 上通常是/Users/你的用户名/.local/bin/uvLinux 上可能是/home/你的用户名/.local/bin/uv。--directory后面的路径指向你克隆下来的 mysql_mcp_server 目录。env里的数据库连接信息要和前面 Docker 启动时设置的一致。如果你改了端口或密码这里同步修改。保存后回到 MCP Servers 列表应该能看到mysql这个服务状态显示为已激活绿色圆点。如果显示红色或灰色说明启动失败去第 5 节看排查方法。3.2 配置 TaoToken 作为模型服务商MCP 服务端配好了还需要一个能调用工具的模型。这里用 TaoToken 接入。进入Settings - Model Provider找到自定义服务商或OpenAI 兼容选项填写{ name: TaoToken, type: openai, base_url: https://taotoken.net/api, api_key: sk-你的Key, models: [gpt-4o, claude-sonnet-4-20250514] }Cherry Studio 的界面操作对应是服务商名称填TaoTokenAPI 地址填https://taotoken.net/apiAPI Key 粘贴你生成的那串。模型列表可以手动添加也可以点获取模型列表自动拉取。添加完成后在Settings - Default Model里把默认模型设为刚添加的 TaoToken 模型。3.3 开启模型的 Function Calling 能力这一步很多人会漏掉。MCP 依赖模型的 Function Calling函数调用能力如果模型不支持或没开启MCP 工具不会被触发。在Model Provider里找到你刚添加的 TaoToken 模型确认它标注了 Function Calling 支持。主流模型如 GPT-4o、Claude Sonnet 系列都原生支持。然后在对话输入框下方找到 MCP 开关选中mysql这个 Server。这样模型在对话时才能看到并调用数据库工具。3.4 配置项速查表配置位置字段值MCP Servers JSONcommanduv 绝对路径MCP Servers JSONMYSQL_HOSTlocalhostMCP Servers JSONMYSQL_DATABASEemployeesModel Providerbase_urlhttps://taotoken.net/apiModel Providerapi_keysk-开头字符串Model Providermodelgpt-4o 或 claude-sonnet-4-20250514输入框MCP 开关选中 mysql4. 验证请求用一句中文查通数据库配置完成后来跑一次真实查询验证链路。在 Cherry Studio 新建对话确认输入框下方的 MCP 开关已经选中mysql然后输入帮我查一下 employees 数据库里一共有多少张表分别叫什么名字发送后你会看到模型先输出一段正在调用工具的提示然后返回类似这样的结果employees 数据库中共有 6 张表分别是 1. departments - 部门信息表 2. dept_emp - 员工部门关联表 3. dept_manager - 部门经理表 4. employees - 员工基本信息表 5. salaries - 薪资记录表 6. titles - 职位记录表再试一个稍微复杂点的查询查询 employees 表中入职时间最早的 5 位员工显示他们的姓名和入职日期模型会生成对应的 SQL通过 MCP 发给 mysql_mcp_server 执行然后把结果整理成表格返回。整个过程你不需要手写任何 SQL。如果你想确认请求确实走了 TaoToken 通道可以在 TaoToken 控制台的用量记录里看到对应的调用日志。地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 。验证成功的标志有三个模型返回了正确的表名列表、查询结果和数据库实际数据一致、TaoToken 控制台有调用记录。三个都满足说明整条链路——Cherry Studio → TaoToken API → 模型推理 → MCP 协议 → mysql_mcp_server → MySQL——完全打通。5. 常见报错排查401、local proxy failed 与 reading choices配置过程中最容易踩的坑集中在这几个报错上逐个说。5.1 401 Unauthorized这是最常见的错误说明 API Key 有问题。可能的原因Key 复制时多了空格或换行。重新从控制台复制一次注意不要带上首尾空白字符。Key 已经失效或被删除。去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 确认 Key 状态。Base URL 填错了。注意是https://taotoken.net/api不要多加/v1或其他路径。有些客户端会自动拼接/v1/chat/completions你只需要填到/api这一层。5.2 local proxy failed 或 connection refused这个报错通常出现在 MCP 服务端启动阶段。Cherry Studio 尝试启动 mysql_mcp_server 但失败了。检查command字段里的 uv 路径是否正确。在终端执行which uv确认然后把这个绝对路径填进去。检查--directory指向的目录是否存在以及该目录下是否有mysql_mcp_server的可执行入口。检查 Python 依赖是否装全。进入 mysql_mcp_server 目录执行pip install -r requirements.txt确认没有报错。如果 MySQL 容器没启动也会导致连接被拒。执行docker ps确认mysql_test容器状态是 Up。5.3 Error reading choices 或返回结果为空这个报错说明请求发出去了但响应格式不对。常见原因模型不支持 Function Calling。换一个支持工具调用的模型比如 GPT-4o 或 Claude Sonnet 系列。MCP 开关没打开。回到输入框下方确认mysql已被选中。模型返回了工具调用请求但 MCP 服务端没有正确响应。检查 mysql_mcp_server 的日志输出看是否有 SQL 执行错误。5.4 OAuth 相关报错如果你在配置过程中看到 OAuth 或 token 相关的错误通常是因为客户端尝试用 OAuth 流程认证但 TaoToken 用的是 API Key 认证。在服务商配置里确认认证方式选的是 API Key 而不是 OAuth。5.5 排查速查表报错信息最可能原因解决方向401 UnauthorizedKey 错误或 Base URL 不对重新复制 Key确认 URL 为 https://taotoken.net/apilocal proxy faileduv 路径错误或依赖缺失which uv 确认路径重装依赖connection refusedMySQL 容器未启动docker ps 检查容器状态Error reading choices模型不支持 Function Calling换用 GPT-4o 或 Claude SonnetOAuth error认证方式选错改为 API Key 认证6. 把这条链路用起来从验证到日常查询链路跑通之后你可以做的事情比想象中多。日常查数据不用再写 SQL 了。比如上个月薪资最高的 10 个部门是哪些、入职超过 15 年还在职的员工有多少直接用中文问就行。模型会自己拼 SQL、调 MCP、整理结果。如果你需要长期做这类数据库交互建议把 TaoToken 的 Coding Plan 用起来。地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 适合需要稳定调用、频繁做 Agent 类任务的场景。一个 Key 覆盖多种模型不用为每个模型单独配一套凭证。想先体验模型对话效果的可以直接去 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 试试不用装任何东西就能验证模型是否满足你的需求。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 里面有各语言 SDK 的调用示例和参数说明。如果你用的是 Claude Code 做开发Anthropic 兼容端点的配置参考 https://taotoken.net/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 。最后提醒一个实际使用中的细节mysql_mcp_server 默认会暴露数据库的查询能力生产环境务必限制数据库账号的权限只给 SELECT 权限不要用 root 账号。测试环境用 root 没问题但上线前一定要换成受限账号。这个坑我在实际项目里见过不止一次。