raduis2136/mysql-mcp-server

基于 FastMCP 构建，运行时动态连接任意 MySQL 实例，让智能体可跨实例查询与诊断

About mysql-mcp-server

MySQL 数据库的 AI 原生交互层，基于 FastMCP 构建。运行时动态连接任意 MySQL 实例，将数据库操作沉淀为 18 个结构化工具，覆盖元数据搜索、性能分析、大表洞察、阻塞诊断、慢查询分析全场景，让 LLM 智能体像资深工程师一样自主完成复杂任务，无需人工介入。

- 上下文感知 — 连接即采集 17 项服务器元数据（版本、隔离级别、sqlmode、bufferpool），为 AI 提供准确运行环境上下文，避免误判。 - 生产安全 — 只读拦截 + 查询超时 + 参数化防注入 + 误杀防护 + 结果集截断 + 请求鉴权，六层防护保障生产库即接即用 - 工具化约束 — 专用工具替代自由 SQL 执行，约束 AI 行为路径，降低误操作与注入风险 - 数据探索链 — searchschema → describeschema → sampledata → countestimate 递进式探索，AI 在充分理解数据结构后再生成 SQL，显著提升准确率 - 故障自处理 — activeconnections → lockwaits → killquery 闭环，AI 自主完成阻塞诊断与处理 - 并发连多库 — 通过 alias 连接池同时连接多个 MySQL 实例，一个智能体可跨实例查询与诊断

Server 监听 http://0.0.0.0:8200/mcp，transport 为 streamable-http。

本 server 的工具用裸名注册（如 connect、killquery），消费端开启 toolnameprefix=True 后实际调用名为 mysqlconnect、mysqlkillquery 等——由适配器统一负责命名空间。

mysqlconnect 连接成功后会自动采集 17 项服务器元数据，作为后续工具调用的上下文，避免 AI 盲猜版本特性：

分组 字段 用途 ------------------ 版本 version、innodbversion 判断特性是否支持（CTE、窗口函数、JSON 等） 身份 serverid、readonly、superreadonly 区分主从、判断可执行操作范围 复制 logbin、gtidmode 判断 binlog 是否开启、复制方式 容量 maxconnections、innodbbufferpoolsize 连接数与内存基线 事务 transactionisolation 默认隔离级别（RR / RC），影响锁行为 语法 sqlmode 严格模式、ONLYFULLGROUPBY 等，决定 SQL 写法 时区 timezone 时间函数与存储行为 慢查询 longquerytime 慢查询阈值，辅助判断 字符集 charactersetserver 默认字符集 双一 innodbflushlogattrxcommit、syncbinlog 持久化与 binlog 同步策略，影响数据安全级别

这些信息随连接返回，AI 无需额外调用即可据此选择正确的 SQL 语法与诊断方向。

以下工具名为开启 toolnameprefix=True 后的实际调用名；server 端以裸名注册（如 connect、killquery），前缀由 langchain-mcp-adapters 自动添加。

工具 参数 说明 ------------------ mysqlconnect host（必填）, port, user, password, database, alias 连接实例，user/password 缺失时从 config.yaml 读取；连接成功自动返回服务器元数据（版本、sqlmode、时区、双一配置等 17 项） mysqldisconnect alias 断

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/raduis2136--mysql-mcp-server.html)

Related MCP servers