Repolode
benborla

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. 1

    需要 Node.js v20+ 以及具有相应权限的 MySQL 用户

  2. 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 数据每日更新。

相关项目