🚀 MySQL MCP 服务器
MySQL MCP 服务器实现了模型上下文协议（MCP），可安全地与 MySQL 数据库进行交互。它提供了一个受控接口，允许 AI 助手列出表格、读取数据以及执行 SQL 查询，让数据库的探索和分析过程更加安全、结构化。
✨ 主要特性
- 可将可用的 MySQL 表作为资源列出。
- 支持读取表内容。
- 能执行 SQL 查询，并进行适当的错误处理。
- 通过环境变量保障数据库访问的安全性。
- 具备全面的日志记录功能。
📦 安装指南
设置以下环境变量：
MYSQL_HOST=localhost # 数据库主机
MYSQL_PORT=3306 # 可选：数据库端口（未指定时默认为3306）
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=your_database
💻 使用示例
基础用法
与 Claude Desktop 一起使用
将以下内容添加到 claude_desktop_config.json：
{
"mcpServers": {
"mysql": {
"command": "python",
"args": [
"-m",
"src.mysql_mcp_server.server"
],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "your_username",
"MYSQL_PASSWORD": "your_password",
"MYSQL_DATABASE": "your_database"
}
}
}
}
高级用法
作为独立服务器运行
# 克隆仓库
git clone https://github.com/designcomputer/mysql_mcp_server.git
cd mysql_mcp_server
# 安装依赖项
pip install -r requirements.txt
# 运行服务器
python -m src.mysql_mcp_server.server
📚 详细文档
开发
# 克隆仓库
git clone https://github.com/designcomputer/mysql_mcp_server.git
cd mysql_mcp_server
# 创建虚拟环境
python -m venv py-mcp-mysql_venv
source py-mcp-mysql_venv/bin/activate # 或 `py-mcp-mysql_venv\Scripts\activate` 在Windows上
# 安装开发依赖项
pip install -r requirements-dev.txt
# 运行测试
pytest
安全注意事项
- 永远不要提交环境变量或凭证。
- 使用权限最小的数据库用户。
- 考虑在生产环境中实现查询白名单。
- 监控和记录所有数据库操作。
安全最佳实践
此 MCP 服务器需要数据库访问权限才能运行。为安全起见：
- 创建一个专用的 MySQL 用户，并赋予最小的权限。
- 不要使用 root 凭证或管理账户。
- 限制数据库访问，使其仅能执行必要的操作。
- 启用日志记录以进行审核。
- 定期进行安全审查以检查数据库访问情况。
查看 MySQL 安全配置指南 获取有关：
- 创建受限的 MySQL 用户。
- 设置适当的权限。
- 监控数据库访问。
- 安全最佳实践的详细说明。
⚠️ 重要提示
在配置数据库访问时，始终遵循最小特权原则。
贡献指南
- 分叉仓库。
- 创建功能分支（
git checkout -b feature/amazing-feature）。 - 提交更改（
git commit -m 'Add some amazing feature'）。 - 推送到分支（
git push origin feature/amazing-feature）。 - 打开 Pull Request。
📄 许可证
MIT License - 详情请见 LICENSE 文件。