MySQL MCP 服务器

一个基于模型上下文协议（MCP）的MySQL数据库交互的安全服务器。该服务器允许AI助手列出表、读取数据以及执行SQL查询，通过受控接口实现对数据库的安全探索和分析。

功能

• 列出可用的MySQL表格作为资源
• 读取表格内容
• 执行带错误处理的SQL查询
• 通过环境变量实现安全的数据库访问
• 全面的日志记录

安装

pip install mysql-mcp-server

配置

设置以下环境变量：

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": "uv",
      "args": [
        "--directory",
        "path/to/mysql_mcp_server",
        "run",
        "mysql_mcp_server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

作为独立服务器运行

• 设置你的数据库参数
• 运行主应用程序

安全注意事项

• 永远不要提交环境变量或凭证
• 使用权限受限的MySQL用户
• 在生产环境中考虑实现查询白名单
• 监控和记录所有数据库操作

最佳安全实践

此MCP服务器需要数据库访问权限才能运行。为确保安全：

1. 创建一个专用的MySQL用户，并赋予最小的权限
2. 禁止使用root凭证或管理账户
3. 限制数据库访问仅限于必要的操作
4. 启用日志记录以进行审核
5. 定期执行安全审查数据库访问

参见MySQL 安全配置指南以了解详细说明：

• 创建受限的MySQL用户
• 设置适当的权限
• 监控数据库访问
• 最佳安全实践

⚠️ 重要提示：始终遵循最小权限原则来配置数据库访问。

许可证

MIT License - 详见LICENSE文件获取详情。

贡献指南

1. Fork 仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开Pull Request