Mysql

🚀 MySQL MCP 服務器

MySQL MCP 服務器實現了模型上下文協議（MCP），可安全地與 MySQL 數據庫進行交互。它提供了一個受控接口，允許 AI 助手列出表格、讀取數據以及執行 SQL 查詢，讓數據庫的探索和分析過程更加安全、結構化。

✨ 主要特性

• 可將可用的 MySQL 表作為資源列出。
• 支持讀取表內容。
• 能執行 SQL 查詢，並進行適當的錯誤處理。
• 通過環境變量保障數據庫訪問的安全性。
• 具備全面的日誌記錄功能。

📦 安裝指南

設置以下環境變量：

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": "python",
      "args": [
        "-m", 
        "src.mysql_mcp_server.server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

高級用法

作為獨立服務器運行

# 克隆倉庫
git clone https://github.com/designcomputer/mysql_mcp_server.git
cd mysql_mcp_server

# 安裝依賴項
pip install -r requirements.txt

# 運行服務器
python -m src.mysql_mcp_server.server

📚 詳細文檔

開發

# 克隆倉庫
git clone https://github.com/designcomputer/mysql_mcp_server.git
cd mysql_mcp_server

# 創建虛擬環境
python -m venv py-mcp-mysql_venv
source py-mcp-mysql_venv/bin/activate  # 或 `py-mcp-mysql_venv\Scripts\activate` 在Windows上

# 安裝開發依賴項
pip install -r requirements-dev.txt

# 運行測試
pytest

安全注意事項

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

安全最佳實踐

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

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

查看 MySQL 安全配置指南 獲取有關：

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

⚠️ 重要提示

在配置數據庫訪問時，始終遵循最小特權原則。

貢獻指南

1. 分叉倉庫。
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。

📄 許可證

MIT License - 詳情請見 LICENSE 文件。