🚀 mcp-server-mysql
模型上下文协议（Model Context Protocol）的 MySQL 数据库服务器，可让大语言模型 inspect 数据库架构并执行只读查询，为数据交互提供便利。
🚀 快速开始
模型上下文协议（Model Context Protocol）的 MySQL 数据库服务器，能使大语言模型对数据库架构进行检查并执行只读查询操作。
✨ 主要特性
- 只读访问 MySQL 数据库，保障数据安全。
- 具备数据库架构检查功能，便于了解数据库结构。
- 在 READ ONLY 事务中安全执行查询，确保操作安全。
- 支持 Docker，方便部署。
- 有 NPM 包可用，便于集成。
📦 安装指南
使用 Docker
# 构建 Docker 镜像
make docker
# 使用 Docker 运行
docker run -i --rm mcp/mysql mysql://host:port/dbname
通过 Smithery 安装
要自动为 Claude Desktop 安装 MySQL 数据库服务器 Smithery，可执行以下命令：
npx -y @smithery/cli install @yuru-sha/mcp-server-mysql --client claude
💻 使用示例
基础用法
与 Claude Desktop 一起使用
将以下配置添加到你的 claude_desktop_config.json 中：
{
"mcpServers": {
"mysql": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"mcp/mysql",
"mysql://host:port/dbname"
]
}
}
}
⚠️ 重要提示
在 macOS 上使用 Docker 时，如果 MySQL 服务器运行在主机网络上，请将
/database替换为host.docker.internal。
连接 URL 格式
mysql://[user][:password]@host[:port]/database
请将 /database 替换为你数据库的名称。
🔧 技术细节
# 初始设置
make setup
# 构建项目
make build
# 格式化代码
make format
# 运行检查工具
make lint
📄 许可证
此项目在 MIT License 下发布。
安全
此服务器强制执行只读访问以保护你的数据库。所有查询都在 READ ONLY 事务中执行。为了增强安全性，我们建议创建一个只读用户。