MySQL MCP服务器
2025.04.03
4
JavaScript数据库服务AI集成数据库
MySQL MCP服务是一个基于Node.js开发的API服务，为Cursor AI提供直接访问MySQL数据库的能力。该服务遵循MCP（Model Control Platform）协议规范，使AI能够通过标准化接口执行SQL查询、获取表结构信息，以及执行数据操作。
View on GitHub
Overview
基本能力
产品定位
MySQL MCP服务是一个为Cursor AI提供MySQL数据库连接与查询能力的MCP服务。
核心功能
- SQL查询执行：支持执行各种SQL语句（SELECT, INSERT, UPDATE, DELETE等）
- 表结构查询：获取数据库表的详细结构信息
- 实时数据访问：为AI提供实时数据库访问能力
- 安全连接：支持通过环境变量配置数据库连接参数
- 跨域支持：内置CORS支持，便于前端应用集成
- 标准化响应：统一的API响应格式，简化集成和使用
- MCP协议支持：完整实现MCP协议，方便与Cursor AI集成
适用场景
- 在Cursor AI中通过自然语言操作数据库
- 需要实时访问MySQL数据库的应用
- 需要标准化接口执行SQL查询的场景
工具列表
- mysql2：MySQL数据库驱动
- Express.js：主要框架
- dotenv：环境变量管理
- cors：跨域支持
常见问题解答
- 服务无法启动
- 检查端口是否被占用:
lsof -i :3100 - 确认Node.js版本是否兼容
-
检查日志文件:
./logs/mysql-mcp-*.log -
数据库连接失败
- 验证数据库连接信息是否正确
- 确认数据库服务是否在运行
-
检查网络连接和防火墙设置
-
API请求失败
- 确认服务是否正常运行:
curl http://localhost:3100/manifest.json - 检查请求格式是否正确
- 查看服务器日志以获取详细错误信息
使用教程
使用依赖
- Node.js 14.x 或更高版本
- MySQL数据库可连接
- Git（可选，用于克隆代码）
安装教程
- 克隆代码仓库
git clone https://github.com/lichuanrong7/mysql-mcp-server.git
cd mysql-mcp-server
- 安装依赖
npm install
- 配置环境变量
创建或编辑
.env文件，添加以下配置：
# 服务器配置
PORT=3100
# 数据库配置
DB_HOST=你的数据库地址
DB_PORT=3306
DB_USER=你的数据库用户名
DB_PASSWORD=你的数据库密码
DB_NAME=你的数据库名称
- 启动服务
# 开发模式启动
npm run dev
# 生产模式启动
npm start
调试方式
- 检查服务是否正常运行:
curl http://localhost:3100/manifest.json - 查看服务器日志:
./logs/mysql-mcp-*.log - 检查数据库连接: 确保数据库服务运行且连接信息正确