MySQL只读管理工具

一个基于FastMCP的MySQL只读管理工具,提供安全查询、表信息查看、结构分析和数据库概览功能,适用于需要安全访问MySQL数据库的场景。

  • by jlau-ice
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 jlau-ice/mysql-mcp

使用说明

MySQL MCP Read-Only Tool

一个基于 FastMCP 的 MySQL 只读管理工具,提供安全查询、表信息查看、结构分析和数据库概览功能,支持多条 SQL 查询、优化建议和查询结果限制。

仅支持只读操作,避免误操作破坏数据库数据。


功能

1. 安全 SQL 查询

  • 仅允许执行只读操作:SELECT, SHOW, DESCRIBE, DESC, EXPLAIN, USE。
  • 自动过滤危险操作:INSERT, UPDATE, DELETE, DROP 等。
  • 检查敏感系统表访问,防止泄露用户信息。
  • 提供查询优化建议:
    • 检查 SELECT * 使用
    • 建议添加 LIMIT 子句
    • 检查缺少 WHERE 条件的查询
  • 支持多条语句,以分号分隔,最多返回 1000 行结果。

2. 智能查询表信息

  • 可按表名或表注释关键词搜索表。
  • 返回表名、表注释、行数估计和大小(MB)。
  • 默认返回最多 50 张表。

3. 获取表结构

  • 查询指定表的字段信息,包括:
    • 字段名、类型、允许空值、默认值、字段注释、键类型、额外信息
  • 支持一次查询多张表(逗号分隔)。

4. 分析表关系

  • 查询外键关系:
    • 主表/字段 → 引用表/字段
    • 更新规则 / 删除规则
  • 支持单表分析或全部表分析。

5. 数据库概览

  • 显示数据库总表数、总行数估计、总大小(MB)。
  • 显示最大的表及其行数和大小。

安装

git clone https://github.com/jlau-ice/mysql-mcp.git
cd mysql-mcp
pip install -r requirements.txt