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

翻译后的中文：

# 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 方式
```json
{
  "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