Mysql MCP

🚀 MySQL MCP 服務器

本項目是一個集成 MySQL 數據庫的 MCP 服務器實現，能為大語言模型（LLM）提供安全的數據庫訪問能力，保障數據交互的安全性與高效性。

🚀 快速開始

本 MySQL MCP 服務器可與 Dive Desktop 配合使用，為大語言模型提供數據庫訪問服務。以下是快速使用步驟：

1. 在 Dive Desktop 中點擊 "+ 添加 MCP 服務器"。
2. 複製並粘貼以下配置：

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/mysql-mcp"
      ],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "",
        "MYSQL_DB": "your_database"
      }
    }
  }
}

3. 點擊"保存"以安裝 MCP 服務器。

若需要，也可以手動啟動服務器：

npx @kevinwatt/mysql-mcp

✨ 主要特性

讀取操作

• 執行只讀 SELECT 查詢。
• 列出所有數據庫表。
• 查看錶結構。
• 顯示模式信息。

寫入操作

• 執行 INSERT/UPDATE/DELETE 操作，帶有事務支持。
• 使用參數化查詢確保數據安全。
• 返回受影響行數和插入 ID。

安全性

• SELECT 查詢的只讀事務模式。
• 查詢長度和結果集大小限制。
• 性能監控和日誌記錄。
• 自動事務處理。

📦 安裝指南

使用以下命令全局安裝：

npm install -g @kevinwatt/mysql-mcp

💻 使用示例

基礎用法

讓您的大語言模型執行以下指令：

"顯示數據庫中所有表格"
"描述 users 表的結構"
"查詢所有活躍用戶"
"向 orders 表插入一條新記錄"

📚 詳細文檔

工具文檔

mysql_query

• 功能：執行只讀 SELECT 查詢。
• 輸入：
  • sql (字符串)：要執行的 SELECT SQL 查詢。
• 限制：
  • 最大查詢長度：4096 字符。
  • 最大結果行數：1000。
  • 查詢超時時間：30 秒。

mysql_execute

• 功能：執行數據修改操作。
• 輸入：
  • sql (字符串)：SQL 語句（INSERT/UPDATE/DELETE）。
  • params (數組，可選)：SQL 語句的參數。
• 功能：
  • 返回受影響行數。
  • 返回最後插入 ID。
  • 自動事務處理。

list_tables

• 功能：列出當前數據庫中的所有表。
• 輸入：無。

describe_table

• 功能：顯示錶結構。
• 輸入：
  • table (字符串)：要描述的表名。

🔧 技術細節

要求

• Node.js 18+ 版本。
• MySQL 服務。
• 兼容 MCP 的 LLM 服務。

📄 許可證

本項目採用 MIT 許可證。

👨‍💻 作者

Dewei Yen

🔑 關鍵字

• mcp
• mysql
• 數據庫
• dive
• llm
• ai