MySQL MCP 安裝配置完整指南

?? 成功案例

版本: @benborla29/mcp-server-mysql@2.0.2
狀態: ? 安裝成功
環境: Windows + Trae.ai

?? 安裝步驟

1. 安裝穩定版本

npm install -g @benborla29/mcp-server-mysql@2.0.2

2. 驗證安裝

npm list -g @benborla29/mcp-server-mysql

應該顯示：@benborla29/mcp-server-mysql@2.0.2

?? 配置文件

基礎配置（只讀模式）

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "@benborla29/mcp-server-mysql@2.0.2"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "root",
        "MYSQL_DB": "admin-demo"
      }
    }
  }
}

高級配置（支持DDL操作）

如果需要執行創建表、刪除表等DDL操作，使用以下配置：

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "@benborla29/mcp-server-mysql@2.0.2"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "root",
        "MYSQL_DB": "admin-demo",
        "SCHEMA_DDL_PERMISSIONS": "true"
      }
    }
  }
}

配置說明

• 基礎配置: 只允許查詢操作（SELECT、SHOW等），安全性高
• 高級配置: 允許DDL操作（CREATE、DROP、ALTER等），功能完整但需謹慎使用
• SCHEMA_DDL_PERMISSIONS: 設置為 "true" 開啟DDL權限

?? 環境要求

MySQL 數據庫

• 服務狀態: 運行中
• 端口: 3306
• 用戶: root
• 密碼: root
• 數據庫: admin-demo

系統環境

• 操作系統: Windows
• Node.js: 已安裝
• npm: 已安裝
• IDE: Trae.ai

?? 使用步驟

基礎使用（只讀模式）

1. 復制配置: 將基礎配置的 JSON 復制到 Trae.ai 的 MCP 設置中
2. 重啟應用: 重啟 Trae.ai 應用
3. 測試連接: 在 Trae.ai 中測試 MySQL MCP 連接
4. 開始使用: 通過自然語言查詢數據庫（僅支持查詢操作）

高級使用（支持DDL操作）

1. 復制高級配置: 將高級配置的 JSON 復制到 Trae.ai 的 MCP 設置中
2. 重啟應用: 重啟 Trae.ai 應用
3. 測試連接: 在 Trae.ai 中測試 MySQL MCP 連接
4. 完整功能: 可以執行查詢、創建表、修改表結構等所有操作

?? 權限選擇建議

• 學習環境: 推薦使用高級配置，方便學習和實驗
• 生產環境: 推薦使用基礎配置，確保數據安全
• 開發環境: 根據需要選擇，建議先用基礎配置測試連接

?? 常用命令

測試數據庫連接

D:\phpstudy_pro\Extensions\MySQL5.7.26\bin\mysql.exe -u root -proot -e "SELECT 1;"

查看數據庫列表

D:\phpstudy_pro\Extensions\MySQL5.7.26\bin\mysql.exe -u root -proot -e "SHOW DATABASES;"

檢查 MySQL 服務狀態

通過 PHPStudy 管理面板查看 MySQL 服務狀態

?? 重要提醒

版本說明

• ? 推薦版本: 2.0.2（穩定）
• ? 避免版本: 2.0.5（Windows 兼容性問題）

配置注意事項

• 每次修改配置后必須重啟 Trae.ai
• 確保 MySQL 服務正在運行
• 確保數據庫 admin-demo 存在
• 用戶 root 需要有訪問權限

?? 故障排除

如果連接失敗

1. 檢查 MySQL 服務: 確保 MySQL 正在運行
2. 驗證數據庫: 確認 admin-demo 數據庫存在
3. 測試連接: 使用命令行測試數據庫連接
4. 重啟應用: 重啟 Trae.ai 應用
5. 檢查版本: 確認使用的是 2.0.2 版本

如果無法執行DDL操作

1. 檢查配置: 確認使用的是高級配置
2. 驗證權限: 確認配置中包含 "SCHEMA_DDL_PERMISSIONS": "true"
3. 重啟應用: 修改配置后必須重啟 Trae.ai
4. 測試權限: 嘗試執行簡單的 CREATE TABLE 語句

常見錯誤

• MCP error -32008: 通常是版本問題，使用 2.0.2 版本解決
• 連接超時: 檢查 MySQL 服務狀態
• 權限錯誤: 檢查用戶權限設置
• DDL operations are not allowed: 需要使用高級配置開啟DDL權限

?? 技術支持

如果遇到問題：

1. 檢查本文檔的故障排除部分
2. 確認環境配置正確
3. 聯系 Trae.ai 技術支持

狀態: ? 驗證可用
適用環境: Windows + Trae.ai + MySQL