MCP MySQL Server Implementation

一個基於NodeJS的MySQL數據庫MCP服務器，允許LLM檢查數據庫模式和執行SQL查詢，支持多數據庫模式和細粒度權限控制。

數據庫開發者工具 #MySQL連接 #數據庫查詢 #權限管理 #多數據庫 .TypeScript

評分 : 2分

下載量 : 18

更新時間 : 2025-04-29

什麼是MySQL MCP服務器？

MySQL MCP服務器是一個允許大型語言模型（LLMs）訪問和操作MySQL數據庫的工具。它提供數據庫模式查看、SQL查詢執行以及數據寫入（如插入、更新、刪除）等功能。

如何使用MySQL MCP服務器？

通過配置環境變量和運行命令，您可以快速設置服務器並與您的數據庫連接。支持多種開發工具和平臺集成，例如Cursor、Claude Desktop和Smithery。

適用場景

適用於需要讓AI直接與MySQL數據庫交互的開發者、數據科學家和企業用戶。支持複雜查詢、多數據庫管理及細粒度權限控制。

主要功能

SQL查詢執行支持複雜的SQL查詢，並返回結果集。

數據庫模式查看自動生成表結構和列信息，方便了解數據庫架構。

數據寫入支持允許執行INSERT、UPDATE和DELETE操作，需手動啟用權限。

多數據庫支持無需指定具體數據庫即可連接多個數據庫。

優勢與侷限性

優勢

簡化AI與數據庫的交互流程

支持多種查詢安全防護機制

兼容主流開發工具和平臺

侷限性

對數據庫性能有一定影響

需要適當的MySQL權限配置

如何使用

安裝依賴

確保已安裝Node.js v18及以上版本。

配置環境變量

設置MySQL連接信息，如主機、端口、用戶名和密碼。

啟動服務器

運行服務器以連接到數據庫。

使用案例

示例1：執行查詢查詢用戶表中的所有記錄。

示例2：插入新記錄向訂單表插入一條新訂單。

常見問題

如何啟用寫操作權限？

如何解決連接失敗的問題？

如何監控查詢性能？

相關資源

官方文檔

全面瞭解服務器功能和配置方法。

GitHub倉庫

源碼地址和貢獻指南。

教程視頻

快速上手視頻教程。

安裝

複製以下命令到你的Client進行配置

{
  "mcpServers": {
    "MySQL": {
      "command": "npx",
      "args": [
        "mcprunner",
        "MYSQL_HOST=127.0.0.1",
        "MYSQL_PORT=3306",
        "MYSQL_USER=root",
        "MYSQL_PASS=root",
        "MYSQL_DB=demostore",
        "ALLOW_INSERT_OPERATION=true",
        "ALLOW_UPDATE_OPERATION=true",
        "ALLOW_DELETE_OPERATION=false",
        "--",
        "npx",
        "-y",
        "@benborla29/mcp-server-mysql"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "/path/to/npx/binary/npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql"
      ],
      "env": {
        // Basic connection settings
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "",
        "MYSQL_DB": "db_name",
        "PATH": "/path/to/node/bin:/usr/bin:/bin",
        
        // Performance settings
        "MYSQL_POOL_SIZE": "10",
        "MYSQL_QUERY_TIMEOUT": "30000",
        "MYSQL_CACHE_TTL": "60000",
        
        // Security settings
        "MYSQL_RATE_LIMIT": "100",
        "MYSQL_MAX_QUERY_COMPLEXITY": "1000",
        "MYSQL_SSL": "true",
        
        // Monitoring settings
        "MYSQL_ENABLE_LOGGING": "true",
        "MYSQL_LOG_LEVEL": "info",
        "MYSQL_METRICS_ENABLED": "true",
        
        // Write operation flags
        "ALLOW_INSERT_OPERATION": "false",
        "ALLOW_UPDATE_OPERATION": "false",
        "ALLOW_DELETE_OPERATION": "false"
      }
    }
  }
}

{
       "mcpServers": {
         "mcp_server_mysql": {
           "command": "/full/path/to/node",
           "args": [
             "/full/path/to/mcp-server-mysql/dist/index.js"
           ],
           "env": {
             "MYSQL_HOST": "127.0.0.1",
             "MYSQL_PORT": "3306",
             "MYSQL_USER": "root",
             "MYSQL_PASS": "your_password",
             "MYSQL_DB": "your_database"
           }
         }
       }
     }

注意：您的密鑰屬於敏感信息，請勿與任何人分享。

🚀 MCP 服務器 MySQL

MCP 服務器 MySQL 是一個相關項目，可幫助你利用 MySQL 進行服務器相關操作，為你的應用提供穩定的數據存儲與交互支持。

🚀 快速開始

若你想使用 MCP 服務器 MySQL，可按照以下步驟進行操作。

📦 安裝指南

Windows 安裝指南

下載 Node.js
訪問 Node.js 官網下載並安裝 Node.js。請確保選擇 LTS 版本以獲得更好的兼容性和穩定性。
驗證安裝
打開命令提示符，輸入以下命令檢查是否安裝成功：

node -v  # 查看 Node.js 版本
npm -v    # 查看 npm 版本

全局安裝 pnpm
使用 npm 安裝 pnpm：

npm install -g pnpm

克隆倉庫
打開命令提示符，運行以下命令克隆 MCP 服務器 MySQL 倉庫：

git clone https://github.com/benborla/mcp-server-mysql.git
cd mcp-server-mysql

安裝依賴項
在倉庫目錄中，運行以下命令安裝所有依賴項：

pnpm install

構建項目
安裝完成後，運行以下命令構建項目：

pnpm run build

啟動 MCP 服務器
構建完成後，運行以下命令啟動 MCP 服務器：

pnpm start

macOS 安裝指南

下載 Node.js
訪問 Node.js 官網下載並安裝 Node.js。請確保選擇 LTS 版本以獲得更好的兼容性和穩定性。
驗證安裝
打開終端，輸入以下命令檢查是否安裝成功：

node -v  # 查看 Node.js 版本
npm -v    # 查看 npm 版本

全局安裝 pnpm
使用 npm 安裝 pnpm：

npm install -g pnpm

克隆倉庫
打開終端，運行以下命令克隆 MCP 服務器 MySQL 倉庫：

git clone https://github.com/benborla/mcp-server-mysql.git
cd mcp-server-mysql

安裝依賴項
在倉庫目錄中，運行以下命令安裝所有依賴項：

pnpm install

構建項目
安裝完成後，運行以下命令構建項目：

pnpm run build

啟動 MCP 服務器
構建完成後，運行以下命令啟動 MCP 服務器：

pnpm start

📚 詳細文檔

配置指南

安裝依賴項

在倉庫目錄中，運行以下命令安裝所有依賴項：

pnpm install

運行 MCP 服務器

要運行 MCP 服務器，請確保項目已構建。然後在終端或命令提示符中運行以下命令：

pnpm start

配置參數

MCP 服務器 MySQL 支持以下配置參數：

port：指定服務器監聽的端口（默認值為 3000）。
host：指定服務器綁定的主機地址（默認值為 localhost）。

示例：

# 配置文件路徑
config:
  port: 3001
  host: 127.0.0.1

常見問題

問題：如何解決 SSL 配置問題？

解答：

確保 MySQL 服務器啟用了 SSL 支持。
檢查 SSL 證書和密鑰文件是否正確配置。
在連接字符串中指定 ssl 屬性。

示例：

# 配置文件路徑
config:
  ssl: true
  cert: /path/to/cert.pem
  key: /path/to/key.pem

問題：如何解決用戶權限問題？

解答：

確保 MySQL 用戶具有足夠的權限。
檢查用戶是否允許從指定的 IP 地址連接。

示例：

# 配置文件路徑
config:
  user: root
  password: yourpassword
  database: yourdatabase

貢獻指南

提交代碼

git checkout -b feature/your-feature-name

提交更改：

git add .
git commit -m "你的提交信息"

推送到遠程倉庫併發起拉取請求：

git push origin feature/your-feature-name

歡迎貢獻！

我們歡迎任何改進或修復。請參考 CONTRIBUTING.md 文件瞭解如何為項目貢獻力量。

問題報告

提交問題

在 GitHub 倉庫中創建一個新的問題。
提供詳細的錯誤日誌和上下文信息。

示例：

# 錯誤日誌路徑
error.log:
Error: Cannot connect to MySQL server

感謝您使用 MCP 服務器 MySQL！如果有任何問題，請隨時提交反饋。

精選MCP服務推薦

Baidu Map

已認證

百度地圖MCP Server是國內首個兼容MCP協議的地圖服務，提供地理編碼、路線規劃等10個標準化API接口，支持Python和Typescript快速接入，賦能智能體實現地圖相關功能。

Markdownify是一個多功能文件轉換服務，支持將PDF、圖片、音頻等多種格式及網頁內容轉換為Markdown格式。

Firecrawl MCP Server是一個集成Firecrawl網頁抓取能力的模型上下文協議服務器，提供豐富的網頁抓取、搜索和內容提取功能。

TypeScript

3.8K

5分

Sequential Thinking MCP Server

一個基於MCP協議的結構化思維服務器，通過定義思考階段幫助分解複雜問題並生成總結

一個基於Python的MCP服務器，通過Notion API提供高級待辦事項管理和內容組織功能，實現AI模型與Notion的無縫集成。

Context7 MCP是一個為AI編程助手提供即時、版本特定文檔和代碼示例的服務，通過Model Context Protocol直接集成到提示中，解決LLM使用過時信息的問題。

Magic Component Platform (MCP) 是一個AI驅動的UI組件生成工具，通過自然語言描述幫助開發者快速創建現代化UI組件，支持多種IDE集成。

JavaScript

1.7K

5分

Edgeone Pages MCP Server

EdgeOne Pages MCP是一個通過MCP協議快速部署HTML內容到EdgeOne Pages並獲取公開URL的服務

智啟未來，您的人工智慧解決方案智庫