mysql-mcp-server

基本能力

产品定位

mysql-mcp-server 是一个为 AI 模型提供 MySQL 数据库操作能力的 MCP 服务器。

核心功能

• 提供多种数据库操作工具，包括创建表、查看表结构、执行查询等。
• 支持通过 MCP 协议与 AI 模型交互。
• 支持 Docker 和 Docker Compose 部署。
• 提供数据分析和报告生成功能。

适用场景

• AI 模型需要与 MySQL 数据库交互的场景。
• 需要自动化执行数据库操作的场景。
• 数据分析和报告生成的场景。

工具列表

• execute_create_table: 创建表
• execute_desc_table: 查看表结构
• execute_explain: 提供查询执行计划
• execute_insert_query: 执行 INSERT 查询
• execute_insight_starter: 检查模式以构建报告
• execute_invoke_viz_pro: 可视化图表推荐
• execute_select_query: 执行 SELECT 查询
• execute_show_tables: 检索表列表

常见问题解答

• 该服务需要 Cursor 版本 0.46 及以上，并且仅限 Cursor Pro 账户用户使用。
• 数据库凭证通过环境变量管理，建议在生产环境中使用强密码。

使用教程

使用依赖

• 需要安装 Docker 或 Python 环境。

安装教程

使用 Docker 运行

docker run -d --name mcp-mysql \
  -e MYSQL_HOST=localhost \
  -e MYSQL_PORT=3306 \
  -e MYSQL_USER=root \
  -e MYSQL_PASSWORD=mcpTest1234!!! \
  -e MYSQL_DATABASE=mcp_test \
  -e MCP_PORT=8081 \
  -p 3306:3306 mineru/mcp-mysql:1.0.0

使用 Docker Compose 运行

docker-compose up -d

直接使用 Python 运行

pip install -r requirements.txt
python mysql_mcp_server/main.py run

调试方式

本地执行

# 设置环境
cp .env.example .env
# 根据需要修改 .env 文件

# 安装依赖
pip install -r requirements.txt

# 运行服务器
python mysql_mcp_server/main.py run

Docker 部署

# 使用 Docker Compose 启动数据库
docker-compose up -d db
# 使用 Docker Compose 构建并运行 mysql-mcp-server（包括重建）
docker-compose up -d --build mysql-mcp-server

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。