🚀 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 能够帮助开发者高效管理数据库，并提供多种实用工具来优化数据库性能。