mysql-mcp-server-plus

# MySQL MCP Server [](https://www.python.org/) [](https://modelcontextprotocol.io/) [](https://docs.astral.sh/uv/) [](LICENSE) 一个基于官方 MCP Python SDK v2 的 MySQL Model Context Protocol（MCP）服务。它通过 **database 白名单**、**MySQL SQL 安全审计** 与 **数据库账号最小权限**，向 MCP 客户端提供受控的 MySQL 查询、元数据读取和可选写入能力。 ## 功能 - 使用官方 `mcp` Python SDK v2，首期采用 stdio transport。 - 使用 `uv` 管理 Python 版本、依赖和锁文件。 - 通过 `MYSQL_ALLOWED_DATABASES` 限制可访问的 database。 - 支持切换当前 database、执行 SQL、列出表、查看表字段/索引、统计表数量。 - 默认只读；关闭只读后仅允许受控 DML 及表、索引、视图相关 DDL。 - 拒绝多语句、注释、账户/权限管理、文件读写、复制、例程、触发器、事件和事务控制等高风险 SQL。 - 查询默认分页，避免单次返回过大结果集。 ## 前置条件 - Python 3.10 或更高版本。 - 已安装 [uv](https://docs.astral.sh/uv/getting-started/installation/)。 - 可访问的 MySQL 服务。建议使用仅具备必要 database 权限的专用账号。 ## 安装 克隆仓库后，在项目根目录执行： ```powershell uv sync --all-groups ``` 该命令会根据 `uv.lock` 创建 `.venv` 并安装所有运行、开发依赖。 ## 配置 服务通过环境变量读取连接与安全配置。 | 环境变量 | 必填 | 默认值 | 说明 | |---|:---:|---|---| | `MYSQL_HOST` | 是 | - | MySQL 主机地址 | | `MYSQL_PORT` | 否 | `3306` | MySQL 端口，范围为 1-65535 | | `MYSQL_USER` | 是 | - | MySQL 用户名 | | `MYSQL_PASSWORD` | 是 | - | MySQL 密码；服务不会写入日志或响应 | | `MYSQL_DEFAULT_DATABASE` | 是 | - | 启动时使用的 database，必须在白名单中 | | `MYSQL_ALLOWED_DATABASES` | 是 | - | 允许访问的 database，以英文逗号分隔 | | `MYSQL_READ_ONLY` | 否 | `true` | `true` 时仅允许安全只读 SQL | | `MYSQL_CONNECT_TIMEOUT` | 否 | `10` | 连接超时秒数，范围为 1-60 | | `MYSQL_LOG_LEVEL` | 否 | `INFO` | `DEBUG`、`INFO`、`WARNING`、`ERROR` 或 `CRITICAL` | PowerShell 示例： ```powershell $env:MYSQL_HOST = "127.0.0.1" $env:MYSQL_PORT = "3306" $env:MYSQL_USER = "mcp_readonly" $env:MYSQL_PASSWORD = "replace-with-a-secret" $env:MYSQL_DEFAULT_DATABASE = "appdb" $env:MYSQL_ALLOWED_DATABASES = "a…