# 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方式
```json
{
"name": "MySQL数据库服务",
"command": "node /path/to/mcp_server_mysql/src/app.js",
"type": "command"
}
```
## 安全性考虑
- 此服务仅限本地使用，不建议暴露到公网
- 使用API密钥保护接口
- 默认只允许执行SELECT查询
## 许可证
MIT