Mysql Database Service

🚀 MySQL數據庫MCP服務

這是一個基於MCP（模型上下文協議）的服務，允許通過Cursor與MySQL數據庫進行交互，實現表的創建、查詢、修改和刪除等操作，為數據庫管理提供了便捷途徑。

✨ 主要特性

• 創建和管理數據庫表
• 執行CRUD操作（創建、讀取、更新、刪除）
• 執行自定義SQL查詢
• 通過MCP協議與Cursor集成

📦 安裝指南

前提條件

• Node.js 18.0.0 或更高版本
• MySQL 數據庫服務器

安裝步驟

1. 克隆或下載本倉庫
2. 安裝依賴：

npm install

3. 配置環境變量：
   • 複製 .env.example 文件為 .env
   • 編輯 .env 文件，填入您的MySQL數據庫連接信息

# 數據庫配置
DB_HOST=localhost
DB_PORT=3006
DB_USER=您的數據庫用戶名
DB_PASSWORD=您的數據庫密碼
DB_NAME=您的數據庫名稱

# 服務器配置
PORT=3001

啟動服務

npm start

服務器將在 http://localhost:3001 啟動（或您在 .env 中指定的端口）。

💻 使用示例

在Cursor中使用

1. 在Cursor中，使用以下方法添加MCP服務：
   • 方法1: 在命令面板中搜索 "MCP" 並選擇添加服務
   • 方法2: 在設置中找到 MCP 相關配置
   • 方法3: 直接使用命令 /connect-mcp http://localhost:3001/sse
2. 連接成功後，您可以通過資源和工具與MySQL數據庫進行交互

可用功能

資源

1. 列出所有表：

mysql://tables

2. 查看錶結構：

mysql://schema/表名

3. 查看錶數據：

mysql://data/表名

工具

1. 創建表：

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

2. 刪除表：

drop-table tableName="表名"

3. 插入數據：

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

4. 更新數據：

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

5. 刪除數據：

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

6. 查詢數據：

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

7. 執行自定義SQL查詢：

execute-sql sql="SELECT * FROM 表名"

示例場景

創建用戶表並插入數據

1. 創建表：

{
  "command": "create-table",
  "tableName": "users",
  "schema": "id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(255), email VARCHAR(255)"
}

2. 插入數據：

{
  "command": "insert-data",
  "tableName": "users",
  "data": {"username": "張三", "email": "zhangsan@example.com"}
}

🔧 技術細節

項目架構

MySQL數據庫MCP服務
├── src/
│   ├── services/
│   │   └── DatabaseService.js
│   ├── controllers/
│   │   └── DatabaseController.js
│   └── routes/
│       └── databaseRoutes.js
└── package.json

📄 許可證

MIT

⚠️ 重要提示

• 不要在代碼或環境變量中存儲敏感的數據庫憑據。
• 限制MySQL用戶的權限，僅允許必要的操作。