MySQL MCP Server

一个带 GUI 配置面板的 MySQL MCP Server，外部使用方式对齐 mcp_ssh，底层改为 MySQL 连接与表操作。

功能

• 多连接管理 - 保存多个 MySQL 连接并选择当前活动连接
• GUI 配置面板 - mysqlgui 一键启动，可视化管理连接
• YAML 导入 - 支持从 Java application.yml/.yaml 自动提取 MySQL 配置
• 一键安装 - 安装到 Windsurf / Cursor / Claude Code / Codex
• MCP 协议 - 通过 stdio 暴露 MySQL 工具
• 全表操作 - 支持查询、DDL、CRUD、表结构查看

安装

pip install mysqlmcp-r

安装完成后即可直接使用命令行入口，不需要额外打包 PyInstaller exe。

pip 安装后如何直接启动 GUI

mysqlgui

mysqlgui 是 pip 根据 pyproject.toml 里的 project.scripts 自动生成的启动命令。
同理，安装后也可以直接使用：

mysqlmcp
mysqlmcp-install

在 Windows 下，你看到的通常会是 mysqlgui.exe / mysqlmcp.exe 这类命令包装器；它们由 pip 自动创建，不是额外单独打包出来的独立 exe。

如果安装后提示找不到 mysqlgui，通常是 Python 的 Scripts 目录没有加入 PATH。此时可先尝试：

python -m mysql_mcp.cli --gui

命令一览

快速开始

# 1. 安装
pip install mysqlmcp-r

# 2. 打开 GUI 管理连接
mysqlgui

# 3. 安装到 IDE
mysqlmcp-install-codex

# 4. 或直接启动 MCP Server
mysqlmcp

GUI 支持

• 手动填写 host / port / username / password / database / charset
• 在“添加/编辑连接”弹窗中选择 YAML 文件自动导入 MySQL datasource
• 测试连接
• 指定当前活动连接

MCP Tools

• list_servers
• connect
• disconnect
• get_status
• exec_sql（禁止执行 DROP TABLE、TRUNCATE TABLE、DROP DATABASE）
• list_databases
• list_tables
• describe_table
• show_create_table
• list_columns
• create_table
• alter_table
• rename_table
• insert_rows（rows 必须是对象数组，支持多行批量插入）
• update_rows（where_clause 支持 ? 或 %s）
• delete_rows（where_clause 支持 ? 或 %s）

手动 MCP 配置

{
  "mcpServers": {
    "mysql": {
      "command": "mysqlmcp"
    }
  }
}

开发测试

python -m pytest -q