适合谁
- 希望使用自然语言查询只读MySQL数据的数据分析师和开发者
- 需要无缝查询本地MySQL数据库的Claude Desktop用户
- 需要与MySQL交互但不想直接编写SQL的团队
M
53FMRS · D
MySQL MCP服务器提供了一种便捷的方式，让Claude通过自然语言查询只读MySQL数据库。它支持动态连接和单一查询覆盖，但安全上仅依赖查询验证，建议使用专用只读用户。功能有限，适用于分析和开发场景，不适合生产环境或需要写入的用途。
MySQL MCP服务器是一个Model Context Protocol实现，允许Claude Desktop使用自然语言与MySQL数据库交互。它只执行只读SQL查询，如SELECT，防止数据修改。支持动态连接配置，可在运行时通过连接字符串切换数据库。通过npm包@hovecapital/read-only-mysql-mcp-server分发，也可从GitHub获取。
工具能力
connect
使用连接字符串连接MySQL数据库，连接持续到断开或更改。
disconnect
断开当前运行时数据库，回退到环境变量配置的默认连接。
query
对当前连接的数据库执行只读SQL查询，可选用一次性连接字符串覆盖。
安装接入
推荐使用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"
}
}
}
}
选型与风险
不适合谁
- 需要写入或修改数据库的应用程序
- 需要连接到非MySQL数据库（如PostgreSQL）的应用程序
- 生产环境中未经额外安全措施和专用只读用户的情况
所需权限
- 需要Node.js v16或更高版本
- 需要MySQL数据库服务器
- 需要Claude Desktop或Claude Code
- 需要数据库凭据（通过环境变量或连接字符串）
- 仅授予SELECT权限，但若凭据权限过高，则可能访问所有数据
风险与副作用
- 误导性安全性：服务器仅阻止非SELECT语句，但若提供的凭据具有写入权限，则可能修改数据；建议使用专用只读用户
- 数据隐私：数据库凭据以环境变量存储，可能被同一系统上的其他进程访问
- 网络暴露：如果MySQL服务器暴露在网络，则可能被未经授权的访问；需确保网络安全
- 资源使用：复杂查询可能消耗大量资源；建议监控查询性能
常见排障
- 重启后配置不生效：确保修改了正确的配置文件并完全重启Claude。
- 连接失败：检查MySQL是否运行，核对凭据，确认网络连通性。
- 路径错误：如果手动安装，确保dist/index.js的绝对路径正确。
- JSON语法错误：验证claude_desktop_config.json的格式。
- 查看日志：运行`node dist/index.js`查看服务器日志。
使用场景
自然语言查询数据库表格和数据
无需手动编写SQL即可查看表结构
获取数据样本进行分析
向非技术用户提供数据库查询能力
支持客户端
Claude Desktop完整支持