MCP MySQL 本地数据库服务

MCP MySQL服务是一个轻量级的个人使用服务程序，用于连接和操作本地MySQL数据库。此服务可作为Cursor的MCP服务使用，通过API接口使Cursor能够轻松地执行各种数据库操作。

特性

• 连接本地MySQL数据库
• 提供RESTful API进行数据库操作
• 支持参数化查询防止SQL注入
• 支持SSE (Server-Sent Events) 推送能力
• 支持作为Cursor MCP服务集成

快速开始

前置条件

• Node.js (v14+)
• MySQL服务器

安装

1. 克隆此仓库
2. 安装依赖

   npm install
   

3. 创建并配置.env文件

   # 服务器配置
   PORT=3000
   NODE_ENV=development
   
   # MySQL数据库配置
   DB_HOST=localhost
   DB_PORT=3306
   DB_USER=你的用户名
   DB_PASSWORD=你的密码
   DB_NAME=你的数据库名
   
   # API配置
   API_KEY=你的API密钥
   

运行

npm start

开发模式（自动重启）:

npm run dev

API接口

获取所有数据库

GET /api/databases

获取数据库的所有表

GET /api/databases/:database/tables

获取表结构

GET /api/databases/:database/tables/:table/structure

执行查询

POST /api/query
Content-Type: application/json

{
  "sql": "SELECT * FROM users WHERE age > ?",
  "params": [18],
  "limit": 10,
  "offset": 0
}

SSE连接

GET /api/sse?apiKey=your-api-key

在Cursor中使用

SSE方式

{
  "name": "MySQL数据库服务",
  "url": "http://localhost:3000/api/sse",
  "type": "sse"
}

Command方式

{
  "name": "MySQL数据库服务",
  "command": "node /path/to/mcp_server_mysql/src/app.js",
  "type": "command"
}

安全性考虑

• 此服务仅限本地使用，不建议暴露到公网
• 使用API密钥保护接口
• 默认只允许执行SELECT查询

许可证

MIT