🚀 MySQL MCP 服务器
MySQL MCP 服务器实现了模型上下文协议（MCP），让 AI 应用程序与 MySQL 数据库能进行安全交互。该服务器组件借助受控接口，促进 AI 应用程序（主机/客户端）和 MySQL 数据库之间的通信，让数据库的探索与分析更安全、更具结构化。
🚀 快速开始
MySQL MCP 服务器并非独立运行的服务器，而是作为 AI 应用程序与 MySQL 数据库之间通信协议的实现组件。
✨ 主要特性
- 🔖 列出可用的 MySQL 表作为资源
- 📖 读取表内容
- 🛠️ 执行 SQL 查询并带有错误处理
- 🔐 通过环境变量实现数据库的安全访问
- 📜 全面的日志记录
📦 安装指南
手动安装
pip install mysql-mcp-server
使用 Smithery 安装
自动通过 Smithery 安装 MySQL MCP Server 以供 Claude 桌面使用：
npx -y @smithery/cli install mysql-mcp-server --client claude
🛠️ 配置
设置以下环境变量：
MYSQL_HOST=localhost # 数据库主机
MYSQL_PORT=3306 # 可选：数据库端口（未指定时默认为 3306）
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=your_database
💻 使用示例
基础用法
在 Claude 桌面中使用
将以下内容添加到 claude_desktop_config.json：
{
"mcpServers": {
"mysql": {
"command": "uv",
"args": [
"--directory",
"path/to/mysql_mcp_server",
"start"
],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "your_username",
"MYSQL_PASSWORD": "your_password",
"MYSQL_DATABASE": "your_database"
}
}
}
}
在 Visual Studio Code 中使用
配置 launch.json 文件以支持调试：
{
"version": "0.2.0",
"configurations": [
{
"name": "启动 MySQL MCP 服务器",
"type": "python",
"request": "launch",
"program": "path/to/mysql_mcp_server/__main__.py",
"args": []
}
]
}
👨💻 开发
要为项目做出贡献，请按照以下步骤操作：
- 克隆仓库：
git clone https://github.com/yourusername/mysql-mcp-server.git - 安装依赖项：
pip install -r requirements.txt - 启动测试环境：
pytest tests/
⚠️ 安全注意事项
- 切勿提交环境变量或凭证到版本控制系统。
- 使用 HTTPS 保护数据库连接。
- 定期更新数据库凭据。
💡 最佳实践
- 避免在生产环境中暴露数据库端口。
- 使用防火墙限制数据库访问。
- 配置审计日志以监控敏感操作。
📄 许可证
项目使用 MIT License。
🤝 贡献指南
- 克隆仓库：
git clone https://github.com/yourusername/mysql-mcp-server.git - 创建功能分支：
git checkout -b feature/amazing-feature - 提交更改：
git commit -m '实现惊人的新特性' - 推送到分支：
git push origin feature/amazing-feature - 提交拉取请求
通过遵循这些步骤，您可以为项目的发展做出宝贵贡献。