← 返回目录

MySQL MCP Server

社区

通过Claude Desktop以自然语言查询MySQL数据库的只读MCP服务器。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 数据库第 35 / 58
Stars: ★ 7 热门
传输方式: stdio（本地进程）
运行环境: Node.js 16+
凭据: 无需凭据
许可证: MIT
最近提交: 47 天前
工具数: 3

53FMRS · D

MySQL MCP服务器提供了一种便捷的方式，让Claude通过自然语言查询只读MySQL数据库。它支持动态连接和单一查询覆盖，但安全上仅依赖查询验证，建议使用专用只读用户。功能有限，适用于分析和开发场景，不适合生产环境或需要写入的用途。

最强项 · 文档质量 14/20 最弱项 · 安全与权限 8/20

可靠性

9/20

安全与权限

8/20

维护活跃度

9/20

文档质量

14/20

安装易用性

13/20

查看各项评分依据

可靠性 9/20: README 声称只允许 SELECT，但未提供任何测试或验证 SELECT 语句如何被解析/阻止多语句或注释绕过的证据；未看到 CI 或测试文件；动态连接功能缺乏错误处理说明。扣分：无执行证据、无测试覆盖、SQL 校验强度未知。
安全与权限 8/20: 未发现恶意行为或凭据外传，无红线问题。但允许运行时通过连接字符串切换到任意主机（可连接生产库/远程库），SELECT-only 依赖黑名单式校验，环境变量明文存放密码，未见参数化查询或行数限制。扣分：动态连接扩大数据边界，校验方式不透明，无危险操作确认机制。
维护活跃度 9/20: 版本 0.2.0，MIT 许可证，7 星 11 个 open issues，无发布节奏、依赖更新或安全响应渠道的证据；未见到 CHANGELOG。扣分：维护活跃度证据不足，issue 响应情况未知。
文档质量 14/20: 文档详尽：多种安装方式、完整配置示例、环境变量表、连接字符串格式、动态连接工作流示例、安全建议和故障排查。扣分：无已知限制/性能说明，无成本提示，缺少对 SELECT 校验边界（如子查询、多语句）的说明。
安装易用性 13/20: 提供 npx 一键安装和完整 Claude Desktop/Claude Code JSON 配置示例，步骤清晰，支持 macOS/Windows。扣分：无 CI/测试证据证明安装路径可靠，mise 等细节需用户自行处理，未提供验证安装成功的步骤。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么连接数据库

适合谁

希望使用自然语言查询只读MySQL数据的数据分析师和开发者
需要无缝查询本地MySQL数据库的Claude Desktop用户
需要与MySQL交互但不想直接编写SQL的团队

不适合谁

需要写入或修改数据库的应用程序
需要连接到非MySQL数据库（如PostgreSQL）的应用程序
生产环境中未经额外安全措施和专用只读用户的情况

所需权限

需要Node.js v16或更高版本
需要MySQL数据库服务器
需要Claude Desktop或Claude Code
需要数据库凭据（通过环境变量或连接字符串）
仅授予SELECT权限，但若凭据权限过高，则可能访问所有数据

风险与副作用

误导性安全性：服务器仅阻止非SELECT语句，但若提供的凭据具有写入权限，则可能修改数据；建议使用专用只读用户
数据隐私：数据库凭据以环境变量存储，可能被同一系统上的其他进程访问
网络暴露：如果MySQL服务器暴露在网络，则可能被未经授权的访问；需确保网络安全
资源使用：复杂查询可能消耗大量资源；建议监控查询性能

安装接入

准备工作

运行环境：Node.js 16+

DB_HOST 必填 MySQL 服务器主机名，默认 mysql，本地通常填 localhost。

DB_DATABASE 必填要连接的数据库名称，使用你自己的数据库名。

DB_USERNAME 必填 MySQL 用户名，建议创建仅拥有 SELECT 权限的只读用户。

DB_PASSWORD 必填密钥 MySQL 密码，来自你自己的 MySQL 账户设置。

其他可选配置项（1 个）

DB_PORT 可选 MySQL 端口，默认 3306。

推荐使用Claude Code CLI：运行claude mcp add mysql -s user -- npx -y @hovecapital/read-only-mysql-mcp-server@latest，然后设置环境变量DB_HOST、DB_PORT、DB_DATABASE、DB_USERNAME、DB_PASSWORD。或者，手动编辑Claude Desktop配置JSON文件（macOS：~/Library/Application Support/Claude/claude_desktop_config.json；Windows：%APPDATA%\Claude\claude_desktop_config.json），在mcpServers中添加服务器配置。

claude_desktop_config.json

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "@hovecapital/read-only-mysql-mcp-server@latest"],
      "env": {
        "DB_HOST": "localhost",
        "DB_PORT": "3306",
        "DB_DATABASE": "your_database_name",
        "DB_USERNAME": "your_username",
        "DB_PASSWORD": "your_password"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@hovecapital/read-only-mysql-mcp-server@latest"
      ],
      "env": {
        "DB_HOST": "localhost",
        "DB_PORT": "3306",
        "DB_DATABASE": "your_database_name",
        "DB_USERNAME": "your_username",
        "DB_PASSWORD": "your_password"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add mysql -e DB_HOST=localhost -e DB_PORT=3306 -e DB_DATABASE=your_database_name -e DB_USERNAME=your_username -e DB_PASSWORD=your_password -- npx -y @hovecapital/read-only-mysql-mcp-server@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

重启客户端后询问“我的数据库里有哪些表？”；如果 connect/query 工具出现在工具列表并返回表名，说明配置成功。

常见排障

重启后配置不生效：确保修改了正确的配置文件并完全重启Claude。
连接失败：检查MySQL是否运行，核对凭据，确认网络连通性。
路径错误：如果手动安装，确保dist/index.js的绝对路径正确。
JSON语法错误：验证claude_desktop_config.json的格式。
查看日志：运行`node dist/index.js`查看服务器日志。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

显示我的数据库里有哪些表
users 表的结构是什么？
从 products 表取前 10 条记录
上个月下了多少笔订单？

工具能力 3

connect 写入

使用连接字符串连接MySQL数据库，连接持续到断开或更改。

disconnect 写入

断开当前运行时数据库，回退到环境变量配置的默认连接。

query 只读

对当前连接的数据库执行只读SQL查询，可选用一次性连接字符串覆盖。

使用场景

自然语言查询数据库表格和数据

无需手动编写SQL即可查看表结构

获取数据样本进行分析

向非技术用户提供数据库查询能力

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

MySQL MCP服务器是一个Model Context Protocol实现，允许Claude Desktop使用自然语言与MySQL数据库交互。它只执行只读SQL查询，如SELECT，防止数据修改。支持动态连接配置，可在运行时通过连接字符串切换数据库。通过npm包@hovecapital/read-only-mysql-mcp-server分发，也可从GitHub获取。