MCP Server Mysql

🚀 MySQL MCP 服務器

MySQL MCP 服務器是一個基於模型上下文協議（MCP）的安全服務器，用於與 MySQL 數據庫進行交互。它允許 AI 助手列出表、讀取數據以及執行 SQL 查詢，通過受控接口實現對數據庫的安全探索和分析。

✨ 主要特性

• 列出可用的 MySQL 表格作為資源。
• 讀取表格內容。
• 執行帶錯誤處理的 SQL 查詢。
• 通過環境變量實現安全的數據庫訪問。
• 全面的日誌記錄。

📦 安裝指南

pip install mysql-mcp-server

📚 詳細文檔

配置

設置以下環境變量：

MYSQL_HOST=localhost     # 數據庫主機
MYSQL_PORT=3306         # 可選：數據庫端口（未指定時默認為3306）
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=your_database

使用方法

與 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"
      }
    }
  }
}

作為獨立服務器運行

• 設置你的數據庫參數。
• 運行主應用程序。

安全注意事項

• 永遠不要提交環境變量或憑證。
• 使用權限受限的 MySQL 用戶。
• 在生產環境中考慮實現查詢白名單。
• 監控和記錄所有數據庫操作。

最佳安全實踐

此 MCP 服務器需要數據庫訪問權限才能運行。為確保安全：

1. 創建一個專用的 MySQL 用戶，並賦予最小的權限。
2. 禁止使用 root 憑證或管理賬戶。
3. 限制數據庫訪問僅限於必要的操作。
4. 啟用日誌記錄以進行審核。
5. 定期執行安全審查數據庫訪問。

參見MySQL 安全配置指南以瞭解詳細說明：

• 創建受限的 MySQL 用戶。
• 設置適當的權限。
• 監控數據庫訪問。
• 最佳安全實踐。

⚠️ 重要提示

始終遵循最小權限原則來配置數據庫訪問。

📄 許可證

MIT License - 詳見 LICENSE 文件獲取詳情。

💡 貢獻指南

1. Fork 倉庫。
2. 創建功能分支（git checkout -b feature/amazing-feature）。
3. 提交更改（git commit -m 'Add some amazing feature'）。
4. 推送到分支（git push origin feature/amazing-feature）。
5. 打開 Pull Request。