深度解析 MySQL 与 MCP 集成：从环境构建到 AI 驱动的数据交互全流程

优质文章学习记录

— 14 min read
深度解析 MySQL 与 MCP 集成：从环境构建到 AI 驱动的数据交互全流程

前言

在当前大语言模型（LLM）应用开发的浪潮中，MCP（Model Context Protocol）协议正在成为连接 AI 模型与本地数据设施的关键桥梁。本文将以 MySQL 数据库为例，详细拆解如何通过 MCP 协议让 AI 模型直接操作关系型数据库，涵盖从服务器发现、数据库架构设计、数据初始化、MCP 配置文件编写到复杂自然语言查询与写入的全过程。

第一部分：MCP 服务器的发现与配置获取

在进行任何数据交互之前，首要任务是确立连接协议与服务源。通过蓝耘 MCP 广场，开发者可以快速检索并获取所需的 MCP 服务器配置。

在搜索栏输入 mysql 关键字，系统会立即检索出相关的 MCP 服务器资源。如下图所示，搜索结果中清晰展示了 MySQL 对应的 MCP 服务卡片。

image.png

点击选中该 MCP 服务器后，界面会跳转至详细的配置详情页。此页面至关重要，它提供了后续在客户端（如 VSCode CodeBuddy 插件）中配置连接所需的 JSON 结构与参数说明，包括环境依赖和启动命令。

image.png

第二部分：数据库基础设施构建

在配置 MCP 连接之前，必须确保底层的 MySQL 数据库环境已经就绪，并且存在可供操作的数据实体。以下操作展示了如何从零开始构建一个名为 lanyun 的数据库实例。

2.1 创建数据库

首先，通过数据库管理工具连接到 MySQL 实例，并执行基础的 DDL（数据定义语言）命令来创建数据库。

createdatabase lanyun;use lanyun;

create database lanyun; 语句用于并在存储系统中初始化一个新的命名空间，随后 use lanyun; 命令将当前的会话上下文切换至该数据库，确保后续的建表与数据插入操作均作用于正确的范围内。

下图展示了该命令执行前的界面状态，此时尚未建立数据库连接。

image.png

执行上述 SQL 语句后，控制台反馈执行成功。此时，一个名为 lanyun 的数据库已经存在于 MySQL 实例中。

image.png

本次演示环境的基础配置参数如下：

  • 用户：root（拥有最高权限，适合测试环境）
  • 数据库名：lanyun
  • 服务端口：3306（MySQL 默认标准端口）

2.2 数据表结构设计（Schema Design）

为了验证 MCP 的复杂查询能力，需要构建一个包含关联关系的业务数据模型。这里设计了三张核心表：users（用户）、products（商品）和 orders（订单），它们之间通过外键构成典型的电商业务模型。

请执行以下 SQL 语句来创建表结构：

-- 用户表CREATETABLEIFNOTEXISTS`users`(`id`INTPRIMARYKEYAUTO_INCREMENTCOMMENT'用户ID',`username`VARCHAR(50)NOTNULLUNIQUECOMMENT'用户名',`email`VARCHAR(100)UNIQUECOMMENT'邮箱',`phone`VARCHAR(20)UNIQUECOMMENT'手机号',`age`TINYINTUNSIGNEDCOMMENT'年龄',`create_time`DATETIMEDEFAULTCURRENT_TIMESTAMPCOMMENT'创建时间')ENGINE=InnoDBDEFAULTCHARSET=utf8mb4 COMMENT='用户信息表';-- 商品表CREATETABLEIFNOTEXISTS`products`(`id`INTPRIMARYKEYAUTO_INCREMENTCOMMENT'商品ID',`name`VARCHAR(100)NOTNULLCOMMENT'商品名称',`price`DECIMAL(10,2)NOTNULLCOMMENT'商品价格',`stock`INTNOTNULLDEFAULT0COMMENT'库存',`category`VARCHAR(50)COMMENT'商品分类',`create_time`DATETIMEDEFAULTCURRENT_TIMESTAMPCOMMENT'创建时间')ENGINE=InnoDBDEFAULTCHARSET=utf8mb4 COMMENT='商品信息表';-- 订单表CREATETABLEIFNOTEXISTS`orders`(`id`INTPRIMARYKEYAUTO_INCREMENTCOMMENT'订单ID',`user_id`INTNOTNULLCOMMENT'用户ID',`product_id`INTNOTNULLCOMMENT'商品ID',`quantity`INTNOTNULLDEFAULT1COMMENT'购买数量',`total_price`DECIMAL(10,2)NOTNULLCOMMENT'订单总价',`status`TINYINTNOTNULLDEFAULT1COMMENT'订单状态：1-待付款，2-已付款，3-已发货，4-已完成，5-已取消',`create_time`DATETIMEDEFAULTCURRENT_TIMESTAMPCOMMENT'创建时间',FOREIGNKEY(`user_id`)REFERENCES`users`(`id`),FOREIGNKEY(`product_id`)REFERENCES`products`(`id`))ENGINE=InnoDBDEFAULTCHARSET=utf8mb4 COMMENT='订单信息表';

技术细节解析：

  1. 引擎选择：所有表均指定 ENGINE=InnoDB，这是为了支持事务处理（ACID）和行级锁定，对于订单系统至关重要。
  2. 字符集：使用 utf8mb4 字符集，能够兼容包括 Emoji 在内的所有 Unicode 字符。
  3. 约束设计：
    • users 表中，username、email、phone 均设置了 UNIQUE 唯一约束，防止重复注册。
    • orders 表通过 FOREIGN KEY 严格定义了引用完整性，确保订单必须归属于存在的用户和存在的商品。
  4. 数据类型：
    • 价格字段使用 DECIMAL(10,2) 而非 FLOAT，以避免浮点数计算时的精度丢失问题。
    • 状态字段使用 TINYINT，节省存储空间。

执行上述 DDL 语句后，数据库表结构初始化完成。

image.png

2.3 初始化测试数据

为了让 MCP 能够检索到有意义的内容，需要向表中预置一定量的模拟数据。

2.3.1 插入用户数据

插入 10 条典型的用户记录，涵盖不同的年龄段和联系方式。

INSERTINTO`users`(`username`,`email`,`phone`,`age`)VALUES('zhangsan','[email protected]','13800138000',25),('lisi','[email protected]','13800138001',30),('wangwu','[email protected]','13800138002',22),('zhaoliu','[email protected]','13800138003',28),('sunqi','[email protected]','13800138004',35),('zhouba','[email protected]','13800138005',26),('wujian','[email protected]','13800138006',29),('chenshi','[email protected]','13800138007',32),('yangjiu','[email protected]','13800138008',24),('huangshi','[email protected]','13800138009',31);

执行结果如下图所示，显示 10 行数据受影响，且无重复键错误。

image.png
2.3.2 插入商品数据

插入 8 条商品数据，涵盖手机、电脑、家电等不同分类，并设置不同的价格梯队。

INSERTINTO`products`(`name`,`price`,`stock`,`category`)VALUES('小米14 Pro',4999.00,200,'手机'),('华为Mate 60 Pro',5999.00,150,'手机'),('苹果MacBook Pro',12999.00,80,'笔记本电脑'),('联想拯救者Y9000P',8999.00,100,'笔记本电脑'),('大疆Mini 4 Pro',3799.00,60,'无人机'),('索尼WH-1000XM5',2499.00,120,'耳机'),('小米空气净化器4 Pro',899.00,180,'智能家居'),('美的电饭煲5L',399.00,250,'家电');

执行状态如下，商品信息已成功存入数据库。

image.png
2.3.3 插入订单数据

这是最关键的一步，因为它建立了用户与商品之间的联系。插入 15 条订单记录，覆盖各种订单状态（待付款、已完成、已取消等）。

INSERTINTO`orders`(`user_id`,`product_id`,`quantity`,`total_price`,`status`)VALUES(1,1,1,4999.00,4),-- 张三购买小米14 Pro，已完成(1,6,1,2499.00,2),-- 张三购买索尼耳机，已付款(2,2,1,5999.00,3),-- 李四购买华为Mate 60 Pro，已发货(3,3,1,12999.00,1),-- 王五购买苹果MacBook Pro，待付款(4,4,1,8999.00,4),-- 赵六购买联想拯救者，已完成(5,5,1,3799.00,2),-- 孙七购买大疆无人机，已付款(6,7,2,1798.00,3),-- 周八购买2台小米净化器，已发货(7,8,1,399.00,1),-- 吴九购买美的电饭煲，待付款(8,1,2,9998.00,4),-- 陈十购买2台小米14 Pro，已完成(9,2,1,5999.00,5),-- 杨九购买华为Mate 60 Pro，已取消(10,3,1,12999.00,2),-- 黄十购买苹果MacBook Pro，已付款(2,6,1,2499.00,4),-- 李四购买索尼耳机，已完成(3,7,1,899.00,3),-- 王五购买小米净化器，已发货(4,8,3,1197.00,1),-- 赵六购买3个美的电饭煲，待付款(5,5,2,7598.00,2);-- 孙七购买2台大疆无人机，已付款

该操作不仅填充了数据，还隐式验证了外键约束的正确性（即 user_id 和 product_id 必须存在于前两张表中）。

image.png

2.4 数据验证

在接入 MCP 之前，手动执行一条查询语句以确保数据落盘无误。

SELECT*FROM`users`LIMIT10;

查询结果如下，可以清晰地看到之前插入的 10 位用户信息，包含 ID、用户名、邮箱等字段。

image.png

至此，数据库层面的准备工作全部完成，数据状态健康且结构完整。

第三部分：MCP 连接配置与环境启动

接下来的核心步骤是在 VSCode 中配置 MCP 客户端（这里使用 CodeBuddy 插件），使其能够通过标准协议与 MySQL 数据库通信。

3.1 JSON 配置详解

在 VSCode 的 CodeBuddy 配置文件中，输入以下 JSON 代码。这段代码定义了一个名为 mysql 的 MCP 服务器实例。

{"mcpServers":{"mysql":{"command":"npx","args":["-y","@kevinwatt/mysql-mcp"],"env":{"MYSQL_HOST":"host","MYSQL_PORT":"3306","MYSQL_USER":"root","MYSQL_PASS":"passwd","MYSQL_DB":"lanyun"}}}}

参数深入解析：

  • command: “npx”：表示使用 Node.js 的包执行器来运行 MCP 服务器。
  • args: 指定了要执行的具体包名 @kevinwatt/mysql-mcp，-y 参数用于自动确认安装提示。这个包本身就是一个实现了 MCP 协议的中间件，负责将 AI 的自然语言指令或函数调用转化为 MySQL 协议包。
  • env (环境变量)：这是最关键的部分，定义了连接数据库所需的凭证。
    • MYSQL_HOST: 数据库主机地址（此处需替换为实际 IP 或 hostname）。
    • MYSQL_PORT: 端口，与前文配置的 3306 一致。
    • MYSQL_USER / MYSQL_PASS: 认证信息。
    • MYSQL_DB: 指定连接 lanyun 数据库。

下图展示了将代码填入配置文件时的界面状态。

image.png

3.2 服务连接确认

配置保存后，插件会自动尝试启动 MCP 服务器。当连接成功建立时，界面会给予明确的反馈。

image.png

MCP 架构的优势在于其透明性。在下图中，系统清晰地展示了 MCP 服务器的运行状态和可用工具列表，表明 AI 现在已经具备了“看到”并“操作”该数据库的能力。

image.png

第四部分：AI 驱动的复杂数据查询

环境搭建完毕后，现在进入实际应用阶段。我们将演示如何通过自然语言让 AI 执行复杂的多表关联查询，并进行数据导出。

4.1 自然语言指令

向 MCP 客户端发送以下包含复杂逻辑的自然语言请求：

1. 查询目标：用户姓名、手机号、购买的商品名称、订单状态、订单创建时间 2. 筛选条件： - 用户年龄大于28岁 - 商品价格大于3000元 - 订单创建时间在2025年1月1日之后 - 订单状态不是“已取消”（status≠5） 3. 排序需求：先按用户年龄降序，再按订单创建时间升序

这个请求涉及到了 users、products、orders 三张表的连接（JOIN），以及多重 WHERE 子句和复合 ORDER BY 排序。

4.2 执行过程与工具调用

AI 接收到指令后，首先通过 MCP 协议获取数据库 Schema，然后构建查询逻辑。下图展示了 AI 正在调用 MCP 工具获取数据，并生成 Python 代码以处理数据导出。

image.png

4.3 结果产出

AI 不仅执行了查询，还利用 Python 环境将结果生成为 Excel 文件。下图展示了生成的 Excel 表格内容，数据结构清晰，完全符合查询要求。

image.png

4.4 SQL 逻辑反查

为了验证 AI 操作的准确性，我们可以查看其生成的底层 SQL 代码。AI 构建的 SQL 如下：

SELECT u.username AS 用户姓名, u.phone AS 手机号, p.name AS 商品名称, o.statusAS 订单状态, o.create_time AS 订单创建时间, u.age AS 用户年龄 -- 排序需要，可根据需求决定是否保留在查询结果中FROM orders o JOIN users u ON o.user_id = u.id JOIN products p ON o.product_id = p.id WHERE u.age >28-- 用户年龄大于28岁AND p.price >3000-- 商品价格大于3000元AND o.create_time >='2025-01-01 00:00:00'-- 订单创建时间在2025年1月1日之后AND o.status!=5-- 订单状态不是已取消ORDERBY u.age DESC,-- 先按用户年龄降序 o.create_time ASC;-- 再按订单创建时间升序

这段 SQL 逻辑严密：

  1. 使用了 JOIN 正确关联了三张表。
  2. WHERE 子句精准对应了所有自然语言中的筛选条件。
  3. ORDER BY 正确实现了复合排序逻辑。

将此 SQL 语句直接在 MySQL 客户端中执行，结果如下图所示。对比可以发现，数据库直接查询的结果与 MCP 导出的 Excel 数据完全一致，证明了 MCP 在处理复杂业务逻辑时的可靠性。

image.png

第五部分：AI 驱动的数据写入操作

除了查询（Read），MCP 同样支持数据写入（Write）操作。以下演示如何通过自然语言批量插入新用户。

5.1 插入指令

发送如下指令：

请基于MySQL数据库执行以下数据插入操作： 1. 目标表：`users`（用户表） 2. 插入字段：`username`（用户名）、`email`（邮箱）、`phone`（手机号）、`age`（年龄） 3. 插入数据： - ('qianer', '[email protected]', '13800138010', 33) - ('songsan', '[email protected]', '13800138011', 38) - ('lixsi', '[email protected]', '13800138012', 29) - ('wangwu_new', '[email protected]', '13800138013', 40) - ('chenliu', '[email protected]', '13800138014', 35)4. 执行要求： - 确保SQL语法符合MySQL规范，字段和值匹配无误 - 执行插入操作后，返回插入结果（如受影响行数、是否成功） - 若存在重复数据（如用户名/手机号/邮箱重复），给出错误处理建议

5.2 执行反馈

MCP 服务器接收指令并将其转换为 INSERT 语句执行。界面反馈显示操作成功完成。

image.png

5.3 写入验证

最后，回到 MySQL 数据库进行验证。由于之前的测试数据 ID 到 10，新插入的数据 ID 应从 11 开始。

执行验证 SQL：

-- 查询新增的5个用户（ID从11开始，对应本次插入）SELECT*FROM`users`WHERE id >=11;

结果如下图所示，5 条新用户数据已精确无误地存入数据库中，且字段对应关系完全正确。

image.png

总结

通过上述流程，本文详细展示了如何利用蓝耘 MCP 广场提供的 MySQL MCP 服务器，实现从数据库搭建、配置编写到 AI 自然语言交互的完整闭环。MCP 协议极大地降低了 AI 接入传统数据设施的门槛，使得复杂的 SQL 编写和数据处理工作可以通过自然语言指令高效完成。

对于希望探索更多 MCP 应用场景的开发者，可以访问蓝耘控制台体验更多服务：

https://console.lanyun.net/#/register?promoterCode=0131

Read more

开箱即用：Qwen1.5-0.5B-Chat轻量级WebUI体验报告

开箱即用：Qwen1.5-0.5B-Chat轻量级WebUI体验报告 1. 为什么需要一个“能跑在笔记本上的AI助手”？ 你有没有过这样的时刻—— 想快速查个技术概念，却懒得打开浏览器； 写周报卡在开头，希望有人帮理清逻辑； 临时要给客户写一封得体的英文邮件，又怕语法出错； 甚至只是想和AI聊两句放松一下，却发现本地部署动辄要24G显存、16G内存…… 现实很骨感：大多数开源大模型像一头大象，而我们的日常设备更像一辆自行车。 但Qwen1.5-0.5B-Chat不是。它是一只麻雀——小，轻，不挑食，飞得稳。 这不是“缩水版”的妥协，而是面向真实使用场景的精准设计： 不依赖GPU，纯CPU即可运行 内存占用低于2GB，连老款MacBook Air都能扛住 启动3秒内完成加载，对话响应平均1.8秒（实测i7-10875H） 自带开箱即用的Web界面，点开浏览器就能聊 它不追求在MMLU榜单上刷分，而是专注解决你此刻手边那个“小问题”。 就像一把好用的瑞士军刀——不炫技，但每次掏出来，都刚好够用。

ClawdBot步骤详解：前端无法访问时的SSH端口转发与Token链接获取

ClawdBot步骤详解：前端无法访问时的SSH端口转发与Token链接获取 1. ClawdBot是什么：你的本地AI助手，不依赖云端服务 ClawdBot 是一个真正属于你自己的个人 AI 助手——它不是网页上点几下就用的 SaaS 工具，而是一个能完整运行在你本地设备（笔记本、台式机、甚至树莓派）上的独立应用。它不像很多“AI助手”那样把你的提示词悄悄发到远端服务器，而是把模型推理、对话管理、插件调度全部留在你自己的机器里。 它的后端由 vLLM 驱动，这意味着你能以极高的吞吐和极低的延迟运行像 Qwen3-4B-Instruct 这样的高质量开源模型。vLLM 的 PagedAttention 技术让显存利用更高效，4GB 显存也能稳稳跑起 4B 级别模型，响应快、不卡顿、不排队。 更重要的是，ClawdBot 的设计哲学是“可控即可靠”。所有配置文件明文可读、所有模型路径清晰可见、所有日志本地留存。你不需要成为 DevOps

树莓派5部署冬瓜HAOS：从零到智能家居中枢实战

1. 准备工作：硬件与软件选择 在开始部署冬瓜HAOS之前，选择合适的硬件和软件是确保系统稳定运行的关键。树莓派5作为最新的单板计算机，性能比前代提升显著，尤其适合作为智能家居中枢。我实测下来，树莓派5的多核处理能力和更高的内存带宽（支持8GB LPDDR4X）能够轻松应对Home Assistant的多任务需求，比如同时处理传感器数据、摄像头流媒体和自动化规则。 硬件方面，除了树莓派5主板，你需要准备以下配件： * TF卡：推荐使用SanDisk Extreme PRO系列（64GB以上，U3 A2 V30规格）。这种高速卡能显著提升系统响应速度，因为HAOS会频繁读写日志和数据库。我试过用普通Class 10卡，启动时间长了近一倍，偶尔还会卡顿。 * 电源适配器：树莓派5需要27W USB-C PD电源（官方电源最稳）。我用过第三方电源，偶尔会触发低压警告，导致系统不稳定。 * 散热方案：树莓派5运行时CPU温度可能飙到70°C以上，建议加装散热风扇或金属散热片。我用的是一体化散热外壳，待机温度控制在40°C左右。 * 外设：HDMI显示器、

Spring Boot集成WebSocket，实现后台向前端推送信息

1. 引言 随着互联网应用的不断发展，用户对实时性的要求越来越高。传统的HTTP协议是基于请求-响应模式的，客户端发起请求，服务器返回响应，连接即关闭。这种“拉取”模式在处理实时数据（如股票行情、即时消息、游戏对战、系统通知等）时显得力不从心：要么客户端频繁轮询造成资源浪费，要么服务器有新数据却无法主动通知客户端。 WebSocket协议的出现完美解决了这一难题。它允许服务器主动向客户端推送数据，实现真正的双向通信。Spring Boot作为当今最流行的Java微服务框架，对WebSocket提供了良好的支持。本文将深入浅出地讲解如何在Spring Boot中集成WebSocket，实现后台向前端推送信息，涵盖原生WebSocket、STOMP协议、安全集成、集群部署等方方面面，力求让读者能够全面掌握这一技术。 2. WebSocket基础 2.1 什么是WebSocket？ WebSocket是一种在单个TCP连接上进行全双工通信的协议。它由IETF在2011年定为标准RFC 6455，并被Web API定义为W3C标准。WebSocket使得客户端和服务器之间的数据交换