一个精简、节省 token 的 MCP 服务器,让 AI 客户端查询和探索 PostgreSQL、MySQL 等多种数据库。
benborla/mcp-server-mysql
让 Claude 等大模型通过 MCP 协议以只读方式访问 MySQL 数据库,可按需开启写操作。
- Star
- 2,175
- Fork
- 260
- 未关闭 Issue
- 51
- 最近提交
- 3个月前
这是什么?
这是一个基于 Model Context Protocol(MCP)的 MySQL 服务器,让 Claude Code、Claude Desktop 等大模型客户端能够查看数据库结构并执行 SQL 查询。默认只读,插入、更新、删除需要分别通过环境变量单独开启,适合让模型探索数据而不改动数据。
除基本查询外,它还提供多项安全与便利功能:支持通过 SSH 隧道连接远程数据库,多库模式可在不重连的情况下跨多个数据库查询,并支持按数据库设置读写权限。结果中的敏感信息可自动脱敏(PII 遮罩),同时支持 SSL/TLS 加密连接及可选的 mTLS。远程模式可通过 HTTP 对外提供服务,并使用 Bearer Token 认证。
项目通过 npx 安装,使用 MYSQL_* 环境变量进行配置。运行环境需要 Node.js 20 及以上,以及 MySQL 5.7 或更高版本,推荐 8.0。
核心功能
- 01默认只读,插入、更新、删除需通过独立环境变量分别开启。
- 02以 MCP 工具和资源的形式提供表结构查看与 SQL 查询。
- 03支持通过 SSH 隧道连接远程数据库。
- 04多库模式可在不重连的情况下跨库查询。
- 05查询结果中的敏感数据自动脱敏。
- 06支持 SSL/TLS 与可选的 mTLS,并提供带 Bearer Token 认证的 HTTP 远程模式。
适用场景
- 让 Claude Code 或 Claude Desktop 查看 MySQL 表结构并回答数据问题。
- 在只读前提下,为 AI 助手提供分析数据的访问能力。
- 通过 SSH 隧道从本地 AI 客户端查询远程 MySQL 实例。
- 在同一个 LLM 会话中完成跨数据库的分析。
快速上手
- 1
需要 Node.js v20+ 以及具有相应权限的 MySQL 用户
- 2
在 Claude Code 中注册该服务器并设置 MySQL 连接环境变量
claude mcp add mcp_server_mysql -e MYSQL_HOST="127.0.0.1" -e MYSQL_PORT="3306" -e MYSQL_USER="root" -e MYSQL_PASS="your_password" -e MYSQL_DB="your_database" -- npx @benborla29/mcp-server-mysql
使用前须知
- 需要 Node.js v20+ 以及 MySQL 5.7+ 数据库(推荐 8.0+)。
- 写操作默认禁用,需通过单独的环境变量标志手动开启。
收录于专题
标签
常见问题
- mcp-server-mysql 是什么?
- 让 Claude 等大模型通过 MCP 协议以只读方式访问 MySQL 数据库,可按需开启写操作。 这是一个基于 Model Context Protocol(MCP)的 MySQL 服务器,让 Claude Code、Claude Desktop 等大模型客户端能够查看数据库结构并执行 SQL 查询。默认只读,插入、更新、删除需要分别通过环境变量单独开启,适合让模型探索数据而不改动数据。
- mcp-server-mysql 可以免费使用吗?用的什么许可证?
- mcp-server-mysql 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- mcp-server-mysql 还在维护吗?
- 半年内有更新。mcp-server-mysql 最近一次提交是在 2026年7月27日。
- mcp-server-mysql 适合用来做什么?
- 让 Claude Code 或 Claude Desktop 查看 MySQL 表结构并回答数据问题。 在只读前提下,为 AI 助手提供分析数据的访问能力。 通过 SSH 隧道从本地 AI 客户端查询远程 MySQL 实例。 在同一个 LLM 会话中完成跨数据库的分析。
- mcp-server-mysql 怎么安装和运行?
- 需要 Node.js v20+ 以及具有相应权限的 MySQL 用户 在 Claude Code 中注册该服务器并设置 MySQL 连接环境变量: claude mcp add mcp_server_mysql -e MYSQL_HOST="127.0.0.1" -e MYSQL_PORT="3306" -e MYSQL_USER="root" -e MYSQL_PASS="your_password" -e MYSQL_DB="your_database" -- npx @benborla29/mcp-server-mysql
- 在哪里获取 mcp-server-mysql?
- 源代码和安装说明在 GitHub 上:https://github.com/benborla/mcp-server-mysql
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
原生数据库 IDE,支持 macOS、Windows 和 Linux,统一连接 PostgreSQL、MySQL、SQLite、Redis 等多种数据库。
支持多种数据库的 AI 数据库客户端,同时提供 MCP 服务器供智能体查询。
免费、本地优先的 AI 辅助数据库客户端与 SQL 工作台,支持 40 多种数据库。
用 TypeScript 构建 MCP 服务器、带 React 视图的 MCP 应用和客户端的全栈框架,内置调试器和 CLI。
一个 MCP 代理服务器,通过单一 HTTP 入口聚合并转发多个 MCP 服务。