mcpField
M
MySQL MCP服务器

MySQL MCP服务器

本地服务
github.com/lichuanrong7数据库1782 周前更新
代码仓库

关于 MySQL MCP服务器

这是一个基于 Node.js 的 MCP 服务，为 Cursor 提供 MySQL 查询和表结构读取能力。它还提供 HTTP 端点，并支持通过 Docker 部署。

主要功能

  1. 01执行 SQL 查询和数据操作
  2. 02获取表结构和 DDL
  3. 03通过环境变量配置数据库连接
  4. 04提供查询和结构信息 HTTP 端点
  5. 05支持 Docker 部署

适用场景

  1. 01在 Cursor 中查询 MySQL 数据
  2. 02开发时检查表结构
  3. 03通过 AI 执行插入、更新或删除操作
  4. 04使用 Docker Compose 部署服务

MCP 相关

它向 MCP 客户端提供 MySQL 查询和表结构能力，并通过 `/manifest.json` 提供清单。README 说明可在 Cursor 中配置该清单 URL。

#mysql#mcp#database#api#cursor

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "mysql-mcp-server-lichuanrong7": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "build"
      ]
    }
  }
}
启动命令docker run -i --rm build

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
ocibuild

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

来自项目 README

MySQL MCP服务器

MySQL Logo
MySQL MCP服务

为Cursor提供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
  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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。