MCP 服务器

MySQL MCP Server

允许 Cursor 通过 MCP 协议与 MySQL 数据库交互，从而能够创建、查询、修改和删除数据库表和记录。

README

MySQL数据库MCP服务

这是一个基于MCP（Model Context Protocol）的服务，允许通过Cursor与MySQL数据库进行交互，实现表的创建、查询、修改和删除等操作。

功能特点

创建和管理数据库表
执行CRUD操作（创建、读取、更新、删除）
执行自定义SQL查询
通过MCP协议与Cursor集成

安装和设置

前提条件

Node.js 18.0.0 或更高版本
MySQL 数据库服务器

安装步骤

克隆或下载本仓库
安装依赖：

npm install

配置环境变量：
- 复制 .env.example 文件为 .env
- 编辑 .env 文件，填入您的MySQL数据库连接信息

# 数据库配置
DB_HOST=localhost
DB_PORT=3306
DB_USER=您的数据库用户名
DB_PASSWORD=您的数据库密码
DB_NAME=您的数据库名称

# 服务器配置
PORT=3001

启动服务

npm start

服务器将在 http://localhost:3001 启动（或您在 .env 中指定的端口）。

在Cursor中使用

在Cursor中，使用以下方法添加MCP服务：
- 方法1: 在命令面板中搜索 "MCP" 并选择添加服务
- 方法2: 在设置中找到 MCP 相关配置
- 方法3: 直接使用命令 /connect-mcp http://localhost:3001/sse
连接成功后，您可以通过资源和工具与MySQL数据库进行交互

可用功能

资源

列出所有表：
```
mysql://tables
```
查看表结构：
```
mysql://schema/表名
```
查看表数据：
```
mysql://data/表名
```

工具

创建表：

create-table tableName="表名" schema="id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(255)"

删除表：
```
drop-table tableName="表名"
```

插入数据：

insert-data tableName="表名" data="{\"name\": \"张三\", \"age\": 30}"

更新数据：

update-data tableName="表名" data="{\"name\": \"李四\"}" condition="{\"id\": 1}"

删除数据：

delete-data tableName="表名" condition="{\"id\": 1}"

查询数据：

query-data tableName="表名" fields="[\"id\",\"name\"]" condition="{\"age\": 30}"

执行自定义SQL：

execute-sql sql="SELECT * FROM users WHERE age > 18" params="[]"

提示模板

创建表指南：
```
create-table-guide tableName="表名"
```
插入数据指南：
```
insert-data-guide tableName="表名"
```
数据库操作概览：
```
database-operations
```

示例场景

创建用户表并添加数据

创建用户表：

create-table tableName="users" schema="id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(255) NOT NULL, email VARCHAR(255) UNIQUE, age INT"

插入用户数据：

insert-data tableName="users" data="{\"name\": \"张三\", \"email\": \"zhangsan@example.com\", \"age\": 30}"

查询用户数据：
```
mysql://data/users
```

项目架构

mcp-db-service/
├── src/
│   ├── db/              # 数据库连接和操作
│   ├── resources/       # MCP资源处理
│   ├── tools/           # MCP工具处理
│   ├── prompts/         # MCP提示模板
│   └── index.js         # 主程序入口
├── .env                 # 环境变量配置
├── .env.example         # 环境变量示例
├── package.json         # 项目配置
└── README.md            # 项目说明

安全注意事项

此服务未实现身份验证和授权机制，请勿在生产环境中使用
建议设置MySQL用户的权限，只允许必要的操作
不要在代码或环境变量中存储敏感的数据库凭据

许可证

MIT


# MySQL 数据库 MCP 服务

这是一个基于 MCP（Model Context Protocol）的服务，允许通过 Cursor 与 MySQL 数据库进行交互，实现表的创建、查询、修改和删除等操作。

## 功能特点

- 创建和管理数据库表
- 执行 CRUD 操作（创建、读取、更新、删除）
- 执行自定义 SQL 查询
- 通过 MCP 协议与 Cursor 集成

## 安装和设置

### 前提条件

- Node.js 18.0.0 或更高版本
- MySQL 数据库服务器

### 安装步骤

1. 克隆或下载本仓库
2. 安装依赖：

```bash
npm install

配置环境变量：
- 复制 .env.example 文件为 .env
- 编辑 .env 文件，填入您的 MySQL 数据库连接信息

# 数据库配置
DB_HOST=localhost
DB_PORT=3306
DB_USER=您的数据库用户名
DB_PASSWORD=您的数据库密码
DB_NAME=您的数据库名称

# 服务器配置
PORT=3001