金大哥 - mysql_mcp_server

article

README

🚀 mcp_mysql_server 中文文档

mcp_mysql_server 是一款功能强大的工具服务器，专注于 MySQL 数据库操作。它支持 SSE 和 STDIO 两种运行模式，提供了 SQL 执行、数据库健康分析等多种实用功能，能助力开发者高效管理数据库。

✨ 主要特性

SQL 执行：可执行各类 SQL 命令，满足多样化的数据库操作需求。
数据库健康分析：对数据库状态进行全面检查，并给出性能优化建议，保障数据库稳定运行。
索引管理：能查看索引状态，同时提供优化建议，提升数据库查询效率。
慢 SQL 分析：帮助识别执行缓慢的 SQL 查询，并提供优化方案，提高系统性能。
死锁问题诊断：深入分析并解决数据库中的死锁问题，确保数据操作的顺利进行。

📦 安装指南

文档中未提及安装步骤，暂不提供相关内容。

📚 详细文档

工具列表

支持工具

| 属性 | 详情 | |------|------| | 工具名 | 功能描述 | | execute_sql | 执行各种 SQL 命令 | | analyze_slow_sql | 分析慢查询并提供优化建议 | | deadlock_analysis | 诊断和解决数据库死锁问题 | | database_health_check | 检查 MySQL 数据库的健康状态 |

提示信息

analyzing-mysql-prompt：用于分析 MySQL 相关问题。
query-table-data-prompt：根据表注释查询数据。

使用说明

SSE 模式配置

配置 mcp client 工具：

{
  "handles": {
    "execute_sql": {
      "type": "tool",
      "description": "执行各种 SQL 命令"
    },
    // 其他工具类似配置
  }
}

修改 config.env 文件，添加数据库信息：

MYSQL_HOST=127.0.0.1
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=password

启动服务：

python server.py

STDIO 模式配置

配置 mcp client 工具如下：

{
  "handles": {
    "execute_sql": {
      "type": "tool",
      "description": "执行各种 SQL 命令"
    },
    // 其他工具类似配置
  }
}

修改 config.env 文件，添加数据库信息：

MYSQL_HOST=127.0.0.1
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=password

启动服务：

python server.py

自定义工具扩展

步骤如下：

在 handles 包中创建新工具类，继承自 BaseHandler。
实现 get_tool_description 和 run_tool 方法。
将新工具导入 __init__.py 文件。

💻 使用示例

基础用法

创建组织结构表并插入数据

# 任务
创建一个组织结构表，包含部门名称、部门编号、所属部门和是否有效字段。

# 要求
- 表名：t_admin_rms_zzjg
- 字段类型：字符串使用 'varchar(255)'，整数使用 'int'，布尔值使用 'boolean'
- 必须包含主键字段，序号 XH 为 varchar(255)
- 表末固定字段： creator-CJR varchar(50)， creation time-CJSJ datetime， modifier-XGR varchar(50)， modification time-XGSJ datetime
- 创建完成后插入 5 条真实数据记录

查询用户信息表中的张三数据

查询用户信息表中张三的数据

分析慢 SQL

分析以下 SQL 执行计划并提供优化建议：
select * from t_jcsjzx_hjkq_cd_xsz_sk xsz
left join t_jcsjzx_hjkq_jcd jcd on jcd.cddm = xsz.cddm

分析死锁问题

update t_admin_rms_zzjg set sfyx = '0' where xh = '1' 执行时卡住，请分析原因

检查 MySQL 健康状态

检查当前 MySQL 的健康状态

通过上述功能和示例，mcp_mysql_server 能够帮助开发者高效管理数据库，并提供多种实用工具来优化数据库性能。

mysql_mcp_server_pro