mysql-mcp-plus

# mysql-mcp-plus `mysql-mcp-plus` 是一个本地运行、仅使用 STDIO 传输的 MySQL MCP 服务。单个 MCP 进程可以声明多个数据源，每次工具调用都必须显式指定 `datasource`，适合把开发、测试、 生产只读库等连接放在同一个 MCP 客户端配置中。 当前版本为 `0.1.1`，正式支持 MySQL 5.7 和 8.x。MariaDB、Percona 仅保证基础连接与 SQL 尽力兼容。 项目只提供通用的数据源发现、连通性检查和 SQL 执行能力，不提供 HTTP/SSE 服务、OAuth、 SSH 隧道、连接池、自动重试、完整 mysql CLI，也不提供专用的表结构、索引或健康检查工具。 ## 运行要求 - Python 3.11 或更高版本 - [uv](https://docs.astral.sh/uv/) - MCP 客户端能够启动本地 STDIO 服务 - 至少一个可访问的 MySQL 账号和数据库 Windows 可通过 WinGet 安装 uv： ```powershell winget install --id astral-sh.uv --exact uv --version ``` macOS/Linux 可使用 uv 官方安装脚本： ```bash curl -LsSf https://astral.sh/uv/install.sh | sh uv --version ``` 安装后如果当前终端还找不到 `uv`，请按安装程序提示把 uv 目录加入 `PATH`，或重新打开终端。 从源码安装依赖： ```console git clone <仓库地址> cd mysql_mcp_plus uv sync --all-groups ``` 验证入口命令可用： ```console uv run mysql-mcp-plus uv run mysql-mcp-multi uv run python -m mysql_mcp_multi ``` `mysql-mcp-plus` 是主命令；`mysql-mcp-multi` 是兼容别名。这三个入口都先验证环境配置， 再启动 STDIO MCP。配置错误写入 stderr 并以退出码 `2` 结束；启动阶段不会连接数据库。 ## 配置 服务只读取进程环境变量，不会自动加载 `.env`。`MYSQL_SOURCES` 声明数据源名称，每个名称 再映射到一组 `MYSQL_<数据源大写>_*` 变量。 ### 全局变量 | 环境变量 | 必填 | 默认值 | 规则 | |---|---:|---:|---| | `MYSQL_SOURCES` | 是 | 无 | 逗号分隔且至少一个；名称匹配 `^[a-z][a-z0-9_]*$`，不可重复或留空 | | `MYSQL_MAX_ROWS_PER_RESULT` | 否 | `1000` | 正整数；单个结果集最多返回的行数 | | `MYSQL_MAX_TOTAL_ROWS` | 否 | `5000` | 正整数，且不得小于单结果集上限；单次调用所有结果集的返回总量 | | `MYSQL_MAX_SQL_BYTES` | 否 | `5242880` | 正整数；按 UTF-8 字节数限制完整 SQL 脚本 | | `MYSQL_MAX_STATEMENTS` | 否 | `5000` | 正整数；单次脚本中的语句数上限 | | `MYSQL_MCP_LOG_LEVEL` | 否 | `INFO` | `DEBUG`、`INFO`、`WARNING`、`ERROR` 或 `CRITICAL`，不区分大小写 | ### 每个数据源的变量 以下表格以名为 `dev` 的数据源为例，实际前缀为 `MYSQL_DEV_`。 | 后缀 | 完整示例 | 必填 | 默认值与规则 | |---|---|---:|---| | `HOST` | `MYSQL_DEV_HOST` | 否 | `localhost`；空值也回退到默认值 | | `PORT` | `MYSQL_DEV_PORT` | 否 | `3306`；整数，范围 `1..65535` | | `USER` | `MYSQL_DEV_USER` | 是 | 去除首尾空白后不可为空 | | `PASSWORD` | `MYSQL_DEV_PASSWORD` | 否 | 空字符串；保留原始值，不做 `.env` 解析 | | `DATABASE` | `MYSQL_DEV_DATABASE` | 是 | 去除首尾空白后不可为空，作为连接默认库 | | `ROLE` | `MYS…