MySQL MCP服务器

MySQL MCP服务器

在 Cursor 工具中使用 MySQL MCP 服务读取本地 MySQL 数据库，方便通过 AI 进行编程开发。

lichuanrong7

开发者工具
访问服务器

README

MySQL MCP服务器

<div align="center"> <img src="https://www.mysql.com/common/logos/mysql-logo.svg" alt="MySQL Logo" width="180" /> <h3>MySQL MCP服务</h3> <p>为Cursor提供MySQL数据库连接与查询能力的MCP服务</p> </div>

📖 项目介绍

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
  1. 安装依赖
npm install
  1. 配置环境变量

创建或编辑 .env 文件，添加以下配置：

# 服务器配置
PORT=3100

# 数据库配置
DB_HOST=你的数据库地址
DB_PORT=3306
DB_USER=你的数据库用户名
DB_PASSWORD=你的数据库密码
DB_NAME=你的数据库名称
  1. 启动服务
# 开发模式启动
npm run dev

# 生产模式启动
npm start

使用启动脚本

项目提供了便捷的启动和停止脚本：

  • 启动服务：

    ./start.sh

  • 停止服务：

    ./stop.sh

Docker部署

  1. 构建Docker镜像
docker build -t mysql-mcp-server .
  1. 使用Docker Compose启动
docker-compose up -d

📝 API文档

主要端点

  • MCP清单: /manifest.json
  • OpenAPI规范: /openapi.yaml
  • SQL查询: /api/mysql/query
  • 表结构查询: /api/mysql/schema
  • DDL查询: /api/mysql/ddl

示例请求

执行SQL查询:

curl -X POST http://localhost:3100/api/mysql/query \
  -H "Content-Type: application/json" \
  -d '{"query":"SELECT * FROM users LIMIT 10"}'

获取表结构:

curl -X GET http://localhost:3100/api/mysql/schema?table=users

🔌 在Cursor中使用

  1. 打开Cursor编辑器
  2. 进入MCP扩展管理界面
  3. 添加新的MCP服务
  4. 输入服务URL: http://localhost:3100/manifest.json
  5. 保存并激活服务

MCP服务激活后，你可以在Cursor中使用自然语言操作数据库：

  • "查询用户表的前10条记录"
  • "获取产品表的结构"
  • "统计每个订单状态的订单数量"

🔍 故障排除

  1. 服务无法启动

    • 检查端口是否被占用: lsof -i :3100
    • 确认Node.js版本是否兼容
    • 检查日志文件: ./logs/mysql-mcp-*.log

  2. 数据库连接失败

    • 验证数据库连接信息是否正确
    • 确认数据库服务是否在运行
    • 检查网络连接和防火墙设置

  3. API请求失败

    • 确认服务是否正常运行: curl http://localhost:3100/manifest.json
    • 检查请求格式是否正确
    • 查看服务器日志以获取详细错误信息

📄 许可证

本项目使用 MIT 许可证 - 详细信息请查看 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

MySQL MCP服务器

<div align="center"> <img src="https://www.mysql.com/common/logos/mysql-logo.svg" alt="MySQL Logo" width="180" /> <h3>MySQL MCP服务</h3> <p>为Cursor提供MySQL数据库连接与查询能力的MCP服务</p> </div>

📖 项目介绍

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
  1. 安装依赖
npm install
  1. 配置环境变量

创建或编辑 .env 文件，添加以下配置：

# 服务器配置
PORT=3100

# 数据库配置
DB_HOST=你的数据库地址
DB_PORT=3306
DB_USER=你的数据库用户名
DB_PASSWORD=你的数据库密码
DB_NAME=你的数据库名称
  1. 启动服务
# 开发模式启动
npm run dev

# 生产模式启动
npm start

使用启动脚本

项目提供了便捷的启动和停止脚本：

  • 启动服务：

    ./start.sh

  • 停止服务：

    ./stop.sh

Docker部署

  1. 构建Docker镜像
docker build -t mysql-mcp-server .
  1. 使用Docker Compose启动
docker-compose up -d

📝 API文档

主要端点

  • MCP清单: /manifest.json
  • OpenAPI规范: /openapi.yaml
  • SQL查询: /api/mysql/query
  • 表结构查询: /api/mysql/schema
  • DDL查询: /api/mysql/ddl

示例请求

执行SQL查询:

curl -X POST http://localhost:3100/api/mysql/query \
  -H "Content-Type: application/json" \
  -d '{"query":"SELECT * FROM users LIMIT 10"}'

获取表结构:

curl -X GET http://localhost:3100/api/mysql/schema?table=users

🔌 在Cursor中使用

  1. 打开Cursor编辑器
  2. 进入MCP扩展管理界面
  3. 添加新的MCP服务
  4. 输入服务URL: http://localhost:3100/manifest.json
  5. 保存并激活服务

MCP服务激活后，你可以在Cursor中使用自然语言操作数据库：

  • "查询用户表的前10条记录"
  • "获取产品表的结构"
  • "统计每个订单状态的订单数量"

🔍 故障排除

  1. 服务无法启动

    • 检查端口是否被占用: lsof -i :3100
    • 确认Node.js版本是否兼容
    • 检查日志文件: ./logs/mysql-mcp-*.log

  2. 数据库连接失败

    • 验证数据库连接信息是否正确
    • 确认数据库服务是否在运行
    • 检查网络连接和防火墙设置

  3. API请求失败

    • 确认服务是否正常运行: curl http://localhost:3100/manifest.json
    • 检查请求格式是否正确
    • 查看服务器日志以获取详细错误信息

📄 许可证

本项目使用 MIT 许可证 - 详细信息请查看 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

MySQL MCP服务器

<div align="center"> <img src="https://www.mysql.com/common/logos/mysql-logo.svg" alt="MySQL Logo" width="180" /> <h3>MySQL MCP服务</h3> <p>为Cursor提供MySQL数据库连接与查询能力的MCP服务</p> </div>

📖 项目介绍

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
  1. 安装依赖
npm install
  1. 配置环境变量

创建或编辑 .env 文件，添加以下配置：

# 服务器配置
PORT=3100

# 数据库配置
DB_HOST=你的数据库地址
DB_PORT=3306
DB_USER=你的数据库用户名
DB_PASSWORD=你的数据库密码
DB_NAME=你的数据库名称
  1. 启动服务
# 开发模式启动
npm run dev

# 生产模式启动
npm start

使用启动脚本

项目提供了便捷的启动和停止脚本：

  • 启动服务：

    ./start.sh

  • 停止服务：

    ./stop.sh

Docker部署

  1. 构建Docker镜像
docker build -t mysql-mcp-server .
  1. 使用Docker Compose启动
docker-compose up -d

📝 API文档

主要端点

  • MCP清单: /manifest.json
  • OpenAPI规范: /openapi.yaml
  • SQL查询: /api/mysql/query
  • 表结构查询: /api/mysql/schema
  • DDL查询: /api/mysql/ddl

示例请求

执行SQL查询:

curl -X POST http://localhost:3100/api/mysql/query \
  -H "Content-Type: application/json" \
  -d '{"query":"SELECT * FROM users LIMIT 10"}'

获取表结构:

curl -X GET http://localhost:3100/api/mysql/schema?table=users

🔌 在Cursor中使用

  1. 打开Cursor编辑器
  2. 进入MCP扩展管理界面
  3. 添加新的MCP服务
  4. 输入服务URL: http://localhost:3100/manifest.json
  5. 保存并激活服务

MCP服务激活后，你可以在Cursor中使用自然语言操作数据库：

  • "查询用户表的前10条记录"
  • "获取产品表的结构"
  • "统计每个订单状态的订单数量"

🔍 故障排除

  1. 服务无法启动

    • 检查端口是否被占用: lsof -i :3100
    • 确认Node.js版本是否兼容
    • 检查日志文件: ./logs/mysql-mcp-*.log

  2. 数据库连接失败

    • 验证数据库连接信息是否正确
    • 确认数据库服务是否在运行
    • 检查网络连接和防火墙设置

  3. API请求失败

    • 确认服务是否正常运行: curl http://localhost:3100/manifest.json
    • 检查请求格式是否正确
    • 查看服务器日志以获取详细错误信息

📄 许可证

本项目使用 MIT 许可证 - 详细信息请查看 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

MySQL MCP服务器

<div align="center"> <img src="https://www.mysql.com/common/logos/mysql-logo.svg" alt="MySQL Logo" width="180" /> <h3>MySQL MCP服务</h3> <p>为Cursor提供MySQL数据库连接与查询能力的MCP服务</p> </div>

📖 项目介绍

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
  1. 安装依赖
npm install
  1. 配置环境变量

创建或编辑 .env 文件，添加以下配置：

# 服务器配置
PORT=3100

# 数据库配置
DB_HOST=你的数据库地址
DB_PORT=3306
DB_USER=你的数据库用户名
DB_PASSWORD=你的数据库密码
DB_NAME=你的数据库名称
  1. 启动服务
# 开发模式启动
npm run dev

# 生产模式启动
npm start

使用启动脚本

项目提供了便捷的启动和停止脚本：

  • 启动服务：

    ./start.sh

  • 停止服务：

    ./stop.sh

Docker部署

  1. 构建Docker镜像
docker build -t mysql-mcp-server .
  1. 使用Docker Compose启动
docker-compose up -d

📝 API文档

主要端点

  • MCP清单: /manifest.json
  • OpenAPI规范: /openapi.yaml
  • SQL查询: /api/mysql/query
  • 表结构查询: /api/mysql/schema
  • DDL查询: /api/mysql/ddl

示例请求

执行SQL查询:

curl -X POST http://localhost:3100/api/mysql/query \
  -H "Content-Type: application/json" \
  -d '{"query":"SELECT * FROM users LIMIT 10"}'

获取表结构:

curl -X GET http://localhost:3100/api/mysql/schema?table=users

🔌 在Cursor中使用

  1. 打开Cursor编辑器
  2. 进入MCP扩展管理界面
  3. 添加新的MCP服务
  4. 输入服务URL: http://localhost:3100/manifest.json
  5. 保存并激活服务

MCP服务激活后，你可以在Cursor中使用自然语言操作数据库：

  • "查询用户表的前10条记录"
  • "获取产品表的结构"
  • "统计每个订单状态的订单数量"

🔍 故障排除

  1. 服务无法启动

    • 检查端口是否被占用: lsof -i :3100
    • 确认Node.js版本是否兼容
    • 检查日志文件: ./logs/mysql-mcp-*.log

  2. 数据库连接失败

    • 验证数据库连接信息是否正确
    • 确认数据库服务是否在运行
    • 检查网络连接和防火墙设置

  3. API请求失败

    • 确认服务是否正常运行: curl http://localhost:3100/manifest.json
    • 检查请求格式是否正确
    • 查看服务器日志以获取详细错误信息

📄 许可证

本项目使用 MIT 许可证 - 详细信息请查看 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

MySQL MCP服务器

<div align="center"> <img src="https://www.mysql.com/common/logos/mysql-logo.svg" alt="MySQL Logo" width="180" /> <h3>MySQL MCP服务</h3> <p>为Cursor提供MySQL数据库连接与查询能力的MCP服务</p> </div>

📖 项目介绍

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
  1. 安装依赖
npm install
  1. 配置环境变量

创建或编辑 .env 文件，添加以下配置：

# 服务器配置
PORT=3100

# 数据库配置
DB_HOST=你的数据库地址
DB_PORT=3306
DB_USER=你的数据库用户名
DB_PASSWORD=你的数据库密码
DB_NAME=你的数据库名称
  1. 启动服务
# 开发模式启动
npm run dev

# 生产模式启动
npm start

使用启动脚本

项目提供了便捷的启动和停止脚本：

  • 启动服务：

    ./start.sh

  • 停止服务：

    ./stop.sh

Docker部署

  1. 构建Docker镜像
docker build -t mysql-mcp-server .
  1. 使用Docker Compose启动
docker-compose up -d

📝 API文档

主要端点

  • MCP清单: /manifest.json
  • OpenAPI规范: /openapi.yaml
  • SQL查询: /api/mysql/query
  • 表结构查询: /api/mysql/schema
  • DDL查询: /api/mysql/ddl

示例请求

执行SQL查询:

curl -X POST http://localhost:3100/api/mysql/query \
  -H "Content-Type: application/json" \
  -d '{"query":"SELECT * FROM users LIMIT 10"}'

获取表结构:

curl -X GET http://localhost:3100/api/mysql/schema?table=users

🔌 在Cursor中使用

  1. 打开Cursor编辑器
  2. 进入MCP扩展管理界面
  3. 添加新的MCP服务
  4. 输入服务URL: http://localhost:3100/manifest.json
  5. 保存并激活服务

MCP服务激活后，你可以在Cursor中使用自然语言操作数据库：

  • "查询用户表的前10条记录"
  • "获取产品表的结构"
  • "统计每个订单状态的订单数量"

🔍 故障排除

  1. 服务无法启动

    • 检查端口是否被占用: lsof -i :3100
    • 确认Node.js版本是否兼容
    • 检查日志文件: ./logs/mysql-mcp-*.log

  2. 数据库连接失败

    • 验证数据库连接信息是否正确
    • 确认数据库服务是否在运行
    • 检查网络连接和防火墙设置

  3. API请求失败

    • 确认服务是否正常运行: curl http://localhost:3100/manifest.json
    • 检查请求格式是否正确
    • 查看服务器日志以获取详细错误信息

📄 许可证

本项目使用 MIT 许可证 - 详细信息请查看 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

MySQL MCP服务器

<div align="center"> <img src="https://www.mysql.com/common/logos/mysql-logo.svg" alt="MySQL Logo" width="180" /> <h3>MySQL MCP服务</h3> <p>为Cursor提供MySQL数据库连接与查询能力的MCP服务</p> </div>

📖 项目介绍

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
  1. 安装依赖
npm install
  1. 配置环境变量

创建或编辑 .env 文件，添加以下配置：

# 服务器配置
PORT=3100

# 数据库配置
DB_HOST=你的数据库地址
DB_PORT=3306
DB_USER=你的数据库用户名
DB_PASSWORD=你的数据库密码
DB_NAME=你的数据库名称
  1. 启动服务
# 开发模式启动
npm run dev

# 生产模式启动
npm start

使用启动脚本

项目提供了便捷的启动和停止脚本：

  • 启动服务：

    ./start.sh

  • 停止服务：

    ./stop.sh

Docker部署

  1. 构建Docker镜像
docker build -t mysql-mcp-server .
  1. 使用Docker Compose启动
docker-compose up -d

📝 API文档

主要端点

  • MCP清单: /manifest.json
  • OpenAPI规范: /openapi.yaml
  • SQL查询: /api/mysql/query
  • 表结构查询: /api/mysql/schema
  • DDL查询: /api/mysql/ddl

示例请求

执行SQL查询:

curl -X POST http://localhost:3100/api/mysql/query \
  -H "Content-Type: application/json" \
  -d '{"query":"SELECT * FROM users LIMIT 10"}'

获取表结构:

curl -X GET http://localhost:3100/api/mysql/schema?table=users

🔌 在Cursor中使用

  1. 打开Cursor编辑器
  2. 进入MCP扩展管理界面
  3. 添加新的MCP服务
  4. 输入服务URL: http://localhost:3100/manifest.json
  5. 保存并激活服务

MCP服务激活后，你可以在Cursor中使用自然语言操作数据库：

  • "查询用户表的前10条记录"
  • "获取产品表的结构"
  • "统计每个订单状态的订单数量"

🔍 故障排除

  1. 服务无法启动

    • 检查端口是否被占用: lsof -i :3100
    • 确认Node.js版本是否兼容
    • 检查日志文件: ./logs/mysql-mcp-*.log

  2. 数据库连接失败

    • 验证数据库连接信息是否正确
    • 确认数据库服务是否在运行
    • 检查网络连接和防火墙设置

  3. API请求失败

    • 确认服务是否正常运行: curl http://localhost:3100/manifest.json
    • 检查请求格式是否正确
    • 查看服务器日志以获取详细错误信息

📄 许可证

本项目使用 MIT 许可证 - 详细信息请查看 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

MySQL MCP服务器

<div align="center"> <img src="https://www.mysql.com/common/logos/mysql-logo.svg" alt="MySQL Logo" width="180" /> <h3>MySQL MCP服务</h3> <p>为Cursor提供MySQL数据库连接与查询能力的MCP服务</p> </div>

📖 项目介绍

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
  1. 安装依赖
npm install
  1. 配置环境变量

创建或编辑 .env 文件，添加以下配置：

# 服务器配置
PORT=3100

# 数据库配置
DB_HOST=你的数据库地址
DB_PORT=3306
DB_USER=你的数据库用户名
DB_PASSWORD=你的数据库密码
DB_NAME=你的数据库名称
  1. 启动服务
# 开发模式启动
npm run dev

# 生产模式启动
npm start

使用启动脚本

项目提供了便捷的启动和停止脚本：

  • 启动服务：

    ./start.sh

  • 停止服务：

    ./stop.sh

Docker部署

  1. 构建Docker镜像
docker build -t mysql-mcp-server .
  1. 使用Docker Compose启动
docker-compose up -d

📝 API文档

主要端点

  • MCP清单: /manifest.json
  • OpenAPI规范: /openapi.yaml
  • SQL查询: /api/mysql/query
  • 表结构查询: /api/mysql/schema
  • DDL查询: /api/mysql/ddl

示例请求

执行SQL查询:

curl -X POST http://localhost:3100/api/mysql/query \
  -H "Content-Type: application/json" \
  -d '{"query":"SELECT * FROM users LIMIT 10"}'

获取表结构:

curl -X GET http://localhost:3100/api/mysql/schema?table=users

🔌 在Cursor中使用

  1. 打开Cursor编辑器
  2. 进入MCP扩展管理界面
  3. 添加新的MCP服务
  4. 输入服务URL: http://localhost:3100/manifest.json
  5. 保存并激活服务

MCP服务激活后，你可以在Cursor中使用自然语言操作数据库：

  • "查询用户表的前10条记录"
  • "获取产品表的结构"
  • "统计每个订单状态的订单数量"

🔍 故障排除

  1. 服务无法启动

    • 检查端口是否被占用: lsof -i :3100
    • 确认Node.js版本是否兼容
    • 检查日志文件: ./logs/mysql-mcp-*.log

  2. 数据库连接失败

    • 验证数据库连接信息是否正确
    • 确认数据库服务是否在运行
    • 检查网络连接和防火墙设置

  3. API请求失败

    • 确认服务是否正常运行: curl http://localhost:3100/manifest.json
    • 检查请求格式是否正确
    • 查看服务器日志以获取详细错误信息

📄 许可证

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

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页进行交互，而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具，可以从自然语言描述生成现代化的用户界面组件，并与流行的集成开发环境（IDE）集成，从而简化用户界面开发流程。

官方
精选
本地
TypeScript
MCP Package Docs Server

MCP Package Docs Server

促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档，通过多语言支持和性能优化来增强软件开发。

精选
本地
TypeScript
Claude Code MCP

Claude Code MCP

一个实现了 Claude Code 作为模型上下文协议（Model Context Protocol, MCP）服务器的方案，它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力（代码生成、编辑、审查和文件操作）。

精选
本地
JavaScript
@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

用于任务管理的模型上下文协议服务器。它允许 Claude Desktop（或任何 MCP 客户端）在基于队列的系统中管理和执行任务。

精选
本地
JavaScript
mermaid-mcp-server

mermaid-mcp-server

一个模型上下文协议 (MCP) 服务器，用于将 Mermaid 图表转换为 PNG 图像。

精选
JavaScript
Jira-Context-MCP

Jira-Context-MCP

MCP 服务器向 AI 编码助手（如 Cursor）提供 Jira 工单信息。

精选
TypeScript
Linear MCP Server

Linear MCP Server

一个模型上下文协议（Model Context Protocol）服务器，它与 Linear 的问题跟踪系统集成，允许大型语言模型（LLM）通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

精选
JavaScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决，支持修订，并通过完整的 MCP 集成来实现多条解决方案路径。

精选
Python
Curri MCP Server

Curri MCP Server

通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要，从而实现与 Curri API 的交互。

官方
本地
JavaScript