Mysql mcp server
一个支持与MySQL数据库安全交互的Model Context Protocol (MCP)服务器
概述
MySQL MCP 服务器
一个实现模型上下文协议(MCP)的服务，用于安全地与MySQL数据库交互。该服务器组件在AI应用程序(主机/客户端)与MySQL数据库之间建立通信，通过受控接口使数据库探索和分析更安全、更有条理。
注意: MySQL MCP Server并非设计为独立服务器，而是作为AI应用程序与MySQL数据库之间的通信协议实现。
功能
- 将可用MySQL表列为资源
- 读取表内容
- 执行带错误处理的SQL查询
- 通过环境变量实现安全数据库访问
- 全面的日志记录
安装
手动安装
bash
pip install mysql-mcp-server通过Smithery安装
为Claude Desktop自动安装MySQL MCP Server，通过Smithery:
bash
npx -y @smithery/cli install mysql-mcp-server --client claude配置
设置以下环境变量：
bash
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:
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"
}
}
}
}与Visual Studio Code配合
添加到mcp.json:
json
{
"servers": {
"mysql": {
"type": "stdio",
"command": "uvx",
"args": [
"--from",
"mysql-mcp-server",
"mysql_mcp_server"
],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "your_username",
"MYSQL_PASSWORD": "your_password",
"MYSQL_DATABASE": "your_database"
}
}
}注意：需要安装uv才能工作
使用MCP检查器调试
虽然MySQL MCP Server不适合作为独立服务或通过Python命令行直接运行，但您可以使用MCP检查器进行调试。
MCP检查器提供便捷的测试和调试方式：
bash
# 安装依赖
pip install -r requirements.txt
# 使用MCP检查器调试（不要直接用Python运行）MySQL MCP Server设计用于与Claude Desktop等AI应用程序集成，不应作为独立Python程序直接运行。
开发
bash
# 克隆仓库
git clone https://github.com/yourusername/mysql_mcp_server.git
cd mysql_mcp_server
# 创建虚拟环境
python -m venv venv
source venv/bin/activate # Windows系统使用`venv\Scripts\activate`
# 安装开发依赖
pip install -r requirements-dev.txt
# 运行测试
pytest安全注意事项
- 切勿提交环境变量或凭证
- 使用具有最小必要权限的数据库用户
- 生产环境考虑实现查询白名单
- 监控并记录所有数据库操作
安全最佳实践
本MCP实现需要数据库访问权限才能工作。为确保安全：
- 创建专用MySQL用户并分配最小权限
- 切勿使用root凭证或管理账户
- 限制数据库访问仅限必要操作
- 启用日志记录用于审计
- 定期进行安全审查数据库访问情况
详见MySQL安全配置指南获取：
- 创建受限MySQL用户的详细说明
- 设置适当权限
- 监控数据库访问
- 安全最佳实践
⚠️ 重要提示：配置数据库访问时始终遵循最小权限原则。
许可证
MIT许可证 - 详见LICENSE文件。
贡献指南
- Fork代码仓库
- 创建特性分支(
git checkout -b feature/amazing-feature) - 提交更改(
git commit -m '添加惊人特性') - 推送分支(
git push origin feature/amazing-feature) - 发起Pull Request
1panel
mcp-1panel 是为 1Panel 实现的 Model Context Protocol (MCP) 服务器。
Aact mcp
与AACT临床试验数据库集成，支持查询和分析大规模试验数据，适用于研究和医疗应用。
Abap Adt
一个服务器，它将模型上下文协议（MCP）与SAP ABAP系统连接起来，使像Cline这样的工具能够检索ABAP源代码、表结构和其他开发工件。
Adwords Mcp
一个令人尴尬的MCP服务器，向Cursor、Claude和其他客户端的开发者提供广告