MySQL MCP 服務器安裝配置最佳實踐

更新時間：2025年06月16日 15:09:14 作者：HeXDev

本文介紹MySQLMCP服務器的安裝配置方法,本文結合實例代碼給大家介紹的非常詳細,對大家的學習或工作具有一定的參考借鑒價值,需要的朋友參考下

MySQL MCP 服務器安裝配置指南

簡介

模型上下文協(xié)議（MCP）的MySQL實現(xiàn)，提供AI應用與MySQL數(shù)據(jù)庫之間的安全交互能力。該服務器組件作為中間層，通過結構化接口使AI應用能夠安全地進行數(shù)據(jù)庫探索與分析。

注意：MySQL MCP服務器不是獨立服務器，而是AI應用與MySQL數(shù)據(jù)庫之間的通信協(xié)議實現(xiàn)。

功能特點

數(shù)據(jù)庫交互：列出表資源、讀取表內容、執(zhí)行SQL查詢
安全機制：通過環(huán)境變量安全訪問數(shù)據(jù)庫，錯誤處理機制
可擴展性：支持多種集成方式（Claude Desktop、VS Code、Cursor）
日志記錄：完善的操作日志，便于審計和調試

安裝方法

通過pip安裝

pip install mysql-mcp-server

通過Smithery安裝（推薦）

為Claude Desktop自動安裝：

npx -y @smithery/cli install mysql-mcp-server --client claude

數(shù)據(jù)庫配置

環(huán)境變量設置

# 必填項
MYSQL_HOST=localhost     # 數(shù)據(jù)庫主機地址
MYSQL_USER=your_username # 數(shù)據(jù)庫用戶名
MYSQL_PASSWORD=your_password # 數(shù)據(jù)庫密碼
MYSQL_DATABASE=your_database # 數(shù)據(jù)庫名稱
# 可選項
MYSQL_PORT=3306         # 數(shù)據(jù)庫端口，默認為3306

使用方法

與Claude Desktop集成

在claude_desktop_config.json中添加：

{
  "mcpServers": {
    "mysql": {
      "command": "uv",
      "args": [
        "--directory", 
        "path/to/mysql_mcp_server",
        "run",
        "mysql_mcp_server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

與Visual Studio Code集成

在mcp.json中添加：

{
  "servers": {
    "mysql": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "mysql-mcp-server",
        "mysql_mcp_server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

提示：集成前需確保已安裝uv包管理器

與Cursor集成

在Cursor設置中配置MySQL MCP服務器：

{
  "mcp": {
    "servers": {
      "mysql": {
        "command": "python",
        "args": [
          "-m",
          "mysql_mcp_server"
        ],
        "env": {
          "MYSQL_HOST": "localhost",
          "MYSQL_PORT": "3306",
          "MYSQL_USER": "your_username",
          "MYSQL_PASSWORD": "your_password",
          "MYSQL_DATABASE": "your_database"
        }
      }
    }
  }
}

注意：確保Cursor已啟用MCP功能，并且MySQL MCP服務器包已正確安裝在當前Python環(huán)境中。

使用MCP Inspector進行調試

雖然MySQL MCP Server不適合直接運行，但您可以使用MCP Inspector進行測試和調試：

# 安裝依賴
pip install -r requirements.txt
# 使用MCP Inspector調試
mcp-inspector mysql_mcp_server

開發(fā)指南

# 克隆倉庫
git clone https://github.com/yourusername/mysql_mcp_server.git
cd mysql_mcp_server
# 創(chuàng)建虛擬環(huán)境
python -m venv venv
source venv/bin/activate  # Windows使用: venv\Scripts\activate
# 安裝開發(fā)依賴
pip install -r requirements-dev.txt
# 運行測試
pytest

安全最佳實踐

數(shù)據(jù)庫權限

創(chuàng)建專用用戶：為MCP服務器創(chuàng)建具有最小權限的專用MySQL用戶
避免使用root：永遠不要使用root賬戶或管理員權限
權限限制：僅授予必要的操作權限（SELECT、特定表的INSERT等）

配置安全

環(huán)境變量保護：不要在代碼或公共倉庫中提交環(huán)境變量或憑證
查詢限制：考慮在生產(chǎn)環(huán)境中實施查詢白名單
日志審計：啟用詳細日志記錄以供安全審計

監(jiān)控與審查

定期審查：定期檢查數(shù)據(jù)庫訪問日志
性能監(jiān)控：監(jiān)控查詢性能和資源使用
安全更新：及時應用安全補丁和更新

重要提示：始終遵循最小權限原則配置數(shù)據(jù)庫訪問。

故障排除

問題	解決方案
連接錯誤	檢查環(huán)境變量配置和網(wǎng)絡連接
權限拒絕	驗證數(shù)據(jù)庫用戶權限設置
性能問題	監(jiān)控查詢復雜度，考慮添加索引
Cursor集成問題	確保在設置中正確啟用了MCP