🚀 mcp-server-mysql
这是一个适用于MySQL数据库的模型上下文协议（Model Context Protocol）服务器，允许大型语言模型（LLM）检查数据库模式并执行只读查询。
🚀 快速开始
mcp-server-mysql 是一个支持大型语言模型与 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 服务器运行在主机网络上，请使用
host.docker.internal。
连接 URL 格式
mysql://[user][:password]@host[:port]/database
请将 /database 替换为您的数据库名称。
🔧 开发指南
# 初始设置
make setup
# 构建项目
make build
# 格式化代码
make format
# 运行检查
make lint
📄 许可证
该项目在 MIT License 下发布。
🛡️ 安全说明
此服务器强制执行只读访问以保护您的数据库。所有查询均在 READ ONLY 事务内执行。
💡 使用建议
为了增强安全性，我们建议创建一个只读用户。
👥 贡献说明
欢迎贡献！请随意提交 Pull Request。