MCP Client 查 MySQL 主键，Base URL 填 TaoToken 的 API

1. 从一次课堂演示说起MCP Client 查 MySQL 主键到底卡在哪MCP 全称 Model Context Protocol是 Anthropic 推出的一套开源标准协议用来把 AI 模型和外部工具、数据源连接起来。你可以把它理解成 AI 应用的 USB-C 接口以前 N 个模型对接 M 个工具可能要写 N×M 套适配代码有了 MCP模型侧只要实现 MCP Client工具侧只要暴露 MCP Server两边按同一套 JSON-RPC 规范说话就行。这次要做的场景很具体用 Claude Desktop 当 MCP Host实例化 MCP Client 去连本地 MySQL MCP Server然后让 AI 直接回答“数据库里有哪些主键值”。真正动手时痛点往往不在 MCP 协议本身而在“模型通道”和“MCP 服务”两套配置是分开的。Claude Desktop 要调模型得有一个可用的 API 通道Key Base URL要查数据库又得在配置文件里加 MySQL MCP Server 的命令、密码、库名。很多人只配了其中一半结果要么模型不响应要么 MCP 服务显示 not running。这篇就按“先通模型通道再接 MCP Server”的顺序把 Base URL 填成 TaoToken 的 API 地址再连本地 MySQL最后验证 AI 能否正常调用工具查到主键。适合正在学 MCP、想跑通第一个数据库查询案例的开发者。2. 前置准备TaoToken 提供模型通道MCP Server 负责数据库先把边界说清楚避免后面混淆。TaoToken 在这里只做一件事给 Claude Desktop 提供模型通道的 Key 和 Base URL。它不替代 MCP Server也不访问你的数据库。数据库查询这件事完全由你本地运行的 MySQL MCP Server 完成TaoToken 不参与。所以整体链路是这样的Claude DesktopMCP Host→ 通过 Base URL 调模型 → 模型判断需要工具 → MCP Client 连本地 MySQL MCP Server → 查库返回结果 → 模型整理成自然语言。你需要准备三样东西第一一个 TaoToken 的 API Key。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册后在控制台创建 Key。这个 Key 只用于模型通道。第二Claude Desktop 客户端。它是 MCP Host负责协调 MCP Client 和模型。第三本地 MySQL 环境以及 uv 工具。MySQL MCP Server 通常用 uv 来拉起所以先装 uvpip install uv装完可以用uv --version确认。如果提示找不到命令检查一下 Python 的 Scripts 目录有没有加进 PATH。注意TaoToken 的 Base URL 填https://taotoken.net/api不要加/v1也不要带任何 UTM 参数。这一点后面配置时会再强调一次。3. 可复制配置Base URL 填 TaoTokenMCP 配置连 MySQL3.1 配置 Claude Desktop 的模型通道Claude Desktop 的配置文件位置按系统区分Windows 一般在%APPDATA%\Claude\claude_desktop_config.json macOS 一般在~/Library/Application Support/Claude/claude_desktop_config.json。如果你用的是支持自定义模型通道的客户端版本模型通道部分需要填两个值API Key 用你在 TaoToken 创建的 KeyBase URL 填https://taotoken.net/api这里再提醒一次不要写成https://taotoken.net/api/v1也不要带?utm_source...之类的参数。Base URL 就是纯地址客户端会自己拼接后续路径。3.2 在同一个配置文件里加 MySQL MCP ServerMCP Server 的配置和模型通道可以放在同一个claude_desktop_config.json里。核心是mcpServers字段每个服务一个名字下面用command和args描述怎么启动。MySQL MCP Server 的典型配置长这样{ mcpServers: { mysql: { command: uvx, args: [ --from, mysql-mcp-server, mysql_mcp_server ], env: { MYSQL_HOST: 127.0.0.1, MYSQL_PORT: 3306, MYSQL_USER: root, MYSQL_PASSWORD: 你的数据库密码, MYSQL_DATABASE: 你的数据库名 } } } }几个参数对照着看字段作用示例command启动命令uvxargs包名和入口--from mysql-mcp-server mysql_mcp_serverMYSQL_HOST数据库地址127.0.0.1MYSQL_PORT端口3306MYSQL_USER用户名rootMYSQL_PASSWORD密码你的真实密码MYSQL_DATABASE库名test_db如果你用的 MySQL MCP Server 包名不同把--from后面的包名换成你实际安装的那个即可。关键是command用uvx它会自动在隔离环境里拉起服务不用你手动建虚拟环境。提示密码里如果有特殊字符JSON 里要正常转义。改完配置保存别急着开客户端先确认 JSON 没有语法错误可以用在线 JSON 校验工具过一遍。4. 验证请求重启后看到 running再问主键值配置保存后完全退出 Claude Desktop 再重新打开。注意是“完全退出”不是关窗口Windows 要在托盘右键退出macOS 用 CmdQ。重启后在客户端的 MCP 服务列表里应该能看到mysql这个服务状态显示 running。如果显示 failed 或 not running先跳到第 5 节排查。确认 running 之后直接向它提问帮我查询数据库有哪些主键值正常流程是这样的模型先判断这个问题需要调用 MCP 工具然后客户端弹出工具授权提示你点击允许MCP Client 按 MCP 协议向本地 MySQL MCP Server 发请求Server 查库后把结果返回模型整理成自然语言告诉你主键有哪些。这里有个安全细节值得注意模型调用 MCP 的语句、参数、返回结果用户都能在界面上看到而且需要你手动授权。这就是 MCP 的安全策略——工具执行不是黑盒你能决定放不放行。如果一切正常你会看到类似“表 xxx 的主键是 id”这样的回答。到这一步说明模型通道TaoToken 的 Key Base URL和 MCP 服务本地 MySQL Server两条链路都通了。5. 本篇常见错排查Base URL、uv、MCP 状态三类问题5.1 模型不响应或报鉴权错误最常见的原因是 Base URL 写错。检查是不是多写了/v1或者复制地址时把 UTM 参数也带进去了。正确写法就是https://taotoken.net/api。另外确认 API Key 没有多余空格Key 是在 TaoToken 控制台创建的别和数据库密码搞混。5.2 MCP 服务显示 not running先看uvx能不能在终端直接跑。打开终端执行uvx --from mysql-mcp-server mysql_mcp_server如果报“command not found”说明 uv 没装好或没进 PATH。如果报数据库连接错误检查MYSQL_HOST、MYSQL_PORT、密码、库名是否和本地实际一致。本地 MySQL 默认只监听 127.0.0.1用 localhost 有时会走 socket建议统一写 127.0.0.1。5.3 服务 running 但查不到主键可能是库名或表名不对或者当前用户没有该库的查询权限。可以先用命令行登录 MySQL 确认SHOW TABLES; SHOW KEYS FROM 你的表名 WHERE Key_name PRIMARY;如果命令行能查到MCP 里查不到检查配置里的MYSQL_DATABASE是不是写成了别的库。还有一种情况是模型没触发工具调用可以换个更明确的问法比如“用 mysql 工具查询 test_db 库里所有表的主键”。5.4 改了配置没生效Claude Desktop 只在启动时读一次配置。改完必须完全退出再开光关窗口不算。如果反复重启还是旧配置检查是不是改错了配置文件路径有些系统会有多个用户目录。6. 配通之后模型通道和 MCP 服务各管一段这套流程跑下来你会发现分工其实很清晰。TaoToken 管的是模型通道给你 Key 和 Base URL让 Claude Desktop 能正常调模型。MySQL MCP Server 管的是数据访问在你本地跑按 MCP 协议把库里的信息暴露给模型。两者通过 Claude Desktop 这个 MCP Host 串起来谁也不越界。如果你后面要长期做编码或 Agent 类任务可以了解下 Coding Plan把模型通道固定下来如果只是想验证某个模型在 MCP 场景下的表现可以直接用模型对话试接入和排障过程中需要的 Key 和文档分别在 API Keys 和接入文档里。地址统一从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 进Base URL 始终是https://taotoken.net/api不带/v1、不加参数。最后留一个实用习惯每次改完claude_desktop_config.json先用uvx在终端手动跑一遍 MCP Server确认能起来再重启客户端。这样能把“配置问题”和“客户端问题”分开排查快很多。