mcp_mysql_server 中文文档

简介

mcp_mysql_server 是一个功能强大的工具服务器，主要用于 MySQL 数据库操作。它支持 SSE 和 STDIO 两种运行模式，并提供多种实用功能，如 SQL 执行、数据库健康分析等。

主要功能

• SQL 执行：支持执行各种 SQL 命令。
• 数据库健康分析：包括数据库状态检查和性能优化建议。
• 索引管理：提供索引状态查看及优化建议。
• 慢 SQL 分析：帮助识别并优化执行缓慢的 SQL 查询。
• 死锁问题诊断：分析解决数据库中的死锁问题。

工具列表

支持工具

提示信息

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

使用说明

SSE 模式配置

1. 配置 mcp client 工具：

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

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

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

3. 启动服务：

   python server.py
   

STDIO 模式配置

1. 配置 mcp client 工具如下：

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

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

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

3. 启动服务：

   python server.py
   

自定义工具扩展

步骤

1. 在 handles 包中创建新工具类，继承自 BaseHandler。
2. 实现 get_tool_description 和 run_tool 方法。
3. 将新工具导入 __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 能够帮助开发者高效管理数据库，并提供多种实用工具来优化数据库性能。