MySQL MCP 服务器

📖 项目介绍

MySQL MCP服务是一个基于Node.js开发的API服务，为Cursor AI提供直接访问MySQL数据库的能力。该服务遵循MCP（Model Control Platform）协议规范，使AI能够通过标准化接口执行SQL查询、获取表结构信息，以及执行数据操作。

✨ 功能特性

• SQL 查询 执行：支持执行各种SQL语句（SELECT, INSERT, UPDATE, DELETE等）
• 表结构查询：获取数据库表的详细结构信息
• 实时数据访问：为AI提供实时数据库访问能力
• 安全连接：支持通过环境变量配置数据库连接参数
• 跨域支持：内置CORS支持，便于前端应用集成
• 标准化响应：统一的API响应格式，简化集成和使用
• MCP协议支持：完整实现MCP协议，方便与Cursor AI集成

🔧 技术栈

• 运行环境：Node.js
• 主要框架：Express.js
• 数据库驱动：mysql2
• 环境变量：dotenv
• 跨域支持：cors

🚀 安装与部署

前置条件

• Node.js 14.x 或更高版本
• MySQL数据库可连接
• Git（可选，用于克隆代码）

安装步骤

1. 克隆代码仓库

git clone https://github.com/lichuanrong7/mysql-mcp-server.git
cd mysql-mcp-server

2. 安装依赖项

npm install

3. 配置环境变量

编辑 .env 文件并填写您的MySQL数据库信息：

DB_HOST=你的数据库主机地址
DB_PORT=你的数据库端口号
DB_USER=你的数据库用户名
DB_PASSWORD=你的数据库密码
DB_NAME=你的数据库名称

4. 启动服务器

npm start

📋 配置

您可以根据需要进一步配置服务，例如：

• 修改 config.json 文件以调整其他设置。
• 添加自定义中间件或路由。

⚠️ 注意事项

• 确保MySQL数据库已正确配置并运行。
• 确保所有环境变量都已正确填写。
• 避免使用生产环境暴露开发环境中的敏感信息。

📄 文档

完整的API文档可以在 docs/api.md 找到，包括所有可用的端点和请求格式。

🛠️ 工具

为了更好地管理和部署此服务，建议使用以下工具：

• Docker：用于容器化部署。
• PM2：用于生产环境中的进程管理。
• Nginx：作为反向代理服务器。

📝 问题与贡献

欢迎报告任何问题或提交改进意见。请访问 GitHub 仓库 查看更多详细信息并参与讨论。

我们非常欢迎您为该项目做出贡献！请遵循以下步骤：

1. Fork 此仓库
2. 在您的Fork中创建功能分支（例如 feature/new-feature）
3. 提交您的更改
4. 推送到GitHub
5. 创建Pull Request

📄 许可证

本项目使用 MIT 许可证 - 详细信息请查看 LICENSE 文件