基于1Panel 部署MySQL MCP 服务：TaoToken 统一 Key 接入与 config.toml 配置实战

1. 为什么要在 1Panel 里给 MySQL 套一层 MCP如果你已经在 1Panel 里跑着 MySQL又想让 Cline、CC Switch 这类 AI 编码工具直接“看懂”你的库表和字段那 MySQL MCP 服务就是那座桥。MCP 全称 Model Context Protocol你可以把它理解成给 AI 工具装的一个“数据库外挂”AI 不再靠你手打表结构而是通过 MCP 服务实时查询 schema、执行只读 SQL把上下文补全。但真正落地时很多人卡在两步一是 1Panel 里 MCP Server 建好了工具却连不上二是每个 AI 工具都要单独配一套模型通道Key 散落各处换模型就得改一遍配置。这篇就聚焦这两件事——用 1Panel 把 MySQL MCP 服务跑起来再用 TaoToken 的统一 Key 和 API 通道把 Cline、CC Switch 接进去最后给一份能直接抄的config.toml骨架和settings.json字段说明。适合谁看已经有 1Panel 和 MySQL 环境、想让 MCP 服务被 AI 工具调用的开发者。全程不需要你懂 MCP 协议细节照着配就能通。2. TaoToken 前置统一 Key 与 API 通道准备在接 MCP 之前先把模型通道这块理顺。TaoToken 的作用是把多家模型的调用收敛到一个 Key、一个 API 地址上这样你的 Cline、CC Switch、MCP 客户端都指向同一个入口换模型只改一个字段不用每个工具重配。你需要准备的东西一个 TaoToken 账号登录后进控制台在 API Keys 页面创建一个 Key复制出来只显示一次存好记下 API 地址https://taotoken.net/api这里有个容易踩的坑MCP 服务本身负责“查数据库”模型通道负责“理解自然语言”两者是分开的。很多人以为配了 MCP 就不用管模型 Key 了结果工具里报 401。正确做法是——MCP 服务用 1Panel 建模型通道用 TaoToken 统一配。如果你还没建 Key可以先去控制台创建控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite创建完 Key 后建议先在模型对话里验证一下 Key 是否可用避免后面排查时分不清是 MCP 的问题还是 Key 的问题模型对话验证https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite3. 1Panel 里创建并配置 MySQL MCP Server登录 1Panel左侧菜单找到 MCP点【创建 MCP Server】。这一步的核心是启动命令它决定了 MCP 服务连哪个库。3.1 启动命令与 DSN 写法名称随便填比如wjobs。启动命令用dbhub这个 MCP 实现格式如下npx -y bytebase/dbhub --transport stdio --dsn mysql://账号:数据库密码IP:端口/数据库名举个具体例子假设你的 MySQL 在192.168.1.11:3306库名wjobs账号密码都是rootnpx -y bytebase/dbhub --transport stdio --dsn mysql://root:root192.168.1.11:3306/wjobsDSN 的拼法记住这个模板mysql://账号:密码IP:端口/库名。密码里如果有特殊字符比如、#要做 URL 编码否则解析会断在错误的位置。3.2 端口与外部访问端口填一个没被占用的比如8010然后打开“端口外部访问”开关。外部访问路径填http://192.168.1.11:8010SSE 路径和容器名称保持默认自动生成即可。填完点确认等状态变成“已启动”。启动成功后点【配置】按钮能看到类似这样的信息{ mcpServers: { wjobs: { url: http://192.168.1.11:8010/wjobs } } }注意这里有个常见笔误有人复制出来发现 URL 里出现了两个http://那是面板显示拼接的问题实际填的时候只保留一个。4. 可复制的 config.toml 骨架与 settings.json 字段MCP 服务跑起来后接下来是让 AI 工具认识它同时把模型通道指向 TaoToken。4.1 config.toml 骨架如果你用的工具支持config.toml比如某些 MCP 客户端或 CLI 工具可以套这个骨架[mcp_servers.wjobs] url http://192.168.1.11:8010/wjobs transport sse [model] provider openai-compatible base_url https://taotoken.net/api api_key 你的TaoToken Key model claude-sonnet-4-20250514关键字段说明字段作用注意mcp_servers.wjobs.urlMCP 服务地址和 1Panel 配置页一致transport传输方式1Panel 默认 SSE填ssebase_url模型 API 入口固定https://taotoken.net/apiapi_key统一 Key从 TaoToken 控制台复制model默认模型按需替换4.2 settings.json 关键字段如果工具用的是settings.jsonCline、CC Switch 常见结构是这样{ mcpServers: { wjobs: { url: http://192.168.1.11:8010/wjobs, transport: sse } }, modelProvider: openai, apiBase: https://taotoken.net/api, apiKey: 你的TaoToken Key, defaultModel: claude-sonnet-4-20250514 }两个文件的核心逻辑一样MCP 段指向 1Panel 的服务地址模型段指向 TaoToken。分开配的好处是哪天你换模型只动model或defaultModel一个字段MCP 那边完全不用碰。5. 验证请求确认 MCP 与 TaoToken 都通了配完别急着用先做两步验证能省掉后面一半的排查时间。5.1 验证 MCP 服务本身在浏览器或终端里直接请求 MCP 的 SSE 端点curl -N http://192.168.1.11:8010/wjobs如果返回一串 SSE 事件流能看到event:或data:开头的内容说明 MCP 服务活着。如果连接被拒回 1Panel 看容器状态和端口映射。5.2 验证 TaoToken 通道用 curl 打一次模型接口确认 Key 和地址没问题curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的TaoToken Key \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: ping}] }返回里有choices字段就说明通道通了。这一步过了再回到 AI 工具里让它查一张表比如问“wjobs 库里有几张表”能列出表名就说明 MCP 和模型通道都串起来了。6. 本篇常见错排查报 401 或 Unauthorized八成是 Key 没填对或者base_url写成了别的地址。检查api_key字段有没有多余空格base_url是不是https://taotoken.net/api。MCP 连不上、工具里看不到库先确认 1Panel 里 MCP 容器是“已启动”再确认端口外部访问开着。如果工具和 1Panel 不在同一台机器192.168.1.11要换成能被访问到的地址。DSN 解析失败密码含特殊字符没编码是最常见原因。另外确认库名拼写mysql://root:rootIP:3306/wjobs里最后那段就是库名。工具里模型能回话但查不了库说明模型通道通了、MCP 没通。回到settings.json检查mcpServers段的 URL 和transportSSE 场景下transport必须是sse。换模型后全部报错只改了model字段但没确认新模型名拼写。模型名要和 TaoToken 支持的列表一致拼错会直接 404。如果你在接入文档里找不到对应字段可以对照官方说明再核一遍接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite长期用 Cline 或 Agent 跑编码任务的建议直接上 Coding Plan省得每次手动换 KeyCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewriteKey 管理和新建入口在这里API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite整套跑下来我的经验是MCP 服务和模型通道一定要分开验证先 curl 通 MCP再 curl 通 TaoToken最后才在工具里合起来用。这样任何一环出问题你都能立刻定位到是哪边而不是对着一个报错瞎猜。