🚀 mcp_mysql_server
mcp_mysql_server_pro不仅支持对 MySQL 进行增删改查操作，还具备数据库异常分析能力，方便开发者扩展自定义工具。
🚀 快速开始
mcp_mysql_server_pro提供了强大且丰富的功能，下面为你详细介绍如何快速上手使用。
✨ 主要特性
- 支持 STDIO 和 SSE 模式。
- 支持以 ";" 分隔的多条 SQL 语句执行。
- 支持根据表注释查询数据库表名和字段。
- 支持 SQL 执行计划分析。
- 支持将中文字段转换为拼音。
- 支持表锁分析。
- 支持数据库健康状态分析。
- 支持三种角色的权限控制：
"readonly": ["SELECT", "SHOW", "DESCRIBE", "EXPLAIN"], # 只读权限 "writer": ["SELECT", "SHOW", "DESCRIBE", "EXPLAIN", "INSERT", "UPDATE", "DELETE"], # 读写权限 "admin": ["SELECT", "SHOW", "DESCRIBE", "EXPLAIN", "INSERT", "UPDATE", "DELETE", "CREATE", "ALTER", "DROP", "TRUNCATE"] # 管理员权限 - 支持提示模板调用。
📚 详细文档
工具列表
以下是可用的工具及其功能：
| 工具名称 | 功能描述 |
|---|---|
| execute_sql | 执行给定的 SQL 查询并返回结果 |
| search_table_by_comment | 根据表注释搜索表名和字段信息 |
| field_to_pinyin | 将中文字段名转换为拼音 |
| analyze_locks | 分析当前数据库的锁状态 |
| analyze_health_status | 检查 MySQL 数据库的健康状态 |
提示语列表
以下是可用的提示语及其作用：
| 提示名称 | 作用描述 |
|---|---|
| create_table_and_insert_data | 创建新表并插入数据 |
| query_data_by_comment | 根据表注释查询数据 |
| analyze_slow_sql | 分析慢 SQL 并提供优化建议 |
| resolve_deadlock | 解决 SQL 死锁问题 |
| check_health_status | 检查 MySQL 健康状态 |
💻 使用示例
SSE 模式配置与启动
- 在
handles文件夹中创建新的工具类，继承BaseHandler，并实现get_tool_description和run_tool方法。 - 将新工具导入到
__init__.py文件中以使其生效。
STDIO 模式使用示例
# 任务
创建一个组织机构表，结构如下：部门名称、部门编号、上级部门、是否有效。
# 要求
- 表名：t_admin_rms_zzjg
- 字段要求：字符串类型使用'varchar(255)'，整数类型使用'int'，浮点数类型使用'float'，日期和时间类型使用'datetime'，布尔类型使用'boolean'，文本类型使用'text'，大文本类型使用'longtext'，大整数类型使用'bigint'，大浮点数类型使用'double'
- 表头需要包含主键字段，流水号XH varchar(255)
- 表必须包含以下固定字段：创建人-CJR varchar(50)，创建时间-CJSJ datetime，修改人-XGR varchar(50)，修改时间-XGSJ datetime
- 字段命名应使用工具返回内容
- 公共字段需要索引
- 每个字段都需要注释，表也需要注释
- 创建后生成5条真实数据记录
查询数据示例
# 提示
查询张三的用户信息数据
分析慢 SQL 示例
select * from t_jcsjzx_hjkq_cd_xsz_sk xsz
left join t_jcsjzx_hjkq_jcd jcd on jcd.cddm = xsz.cddm
根据当前索引情况，审查执行计划并提供优化建议（以Markdown格式），包括表索引状态、执行细节和优化建议
解决 SQL 死锁示例
update t_admin_rms_zzjg set sfyx = '0' where xh = '1' 陷入停滞，请分析原因
检查健康状态示例
检查当前MySQL的健康状态