MCP Server With Claude Ai

🚀 MySQL MCP 服務器

MySQL MCP 服務器是一個實現模型上下文協議（MCP）的數據庫安全交互系統，它能實現 AI 應用程序（主機/客戶端）與 MySQL 數據庫之間的通信，讓數據庫探索和分析更安全、更具結構化。

⚠️ 重要提示

MySQL MCP 服務器設計上並非作為獨立服務器運行，而是作為 AI 應用程序與 MySQL 數據庫之間通信協議的實現組件。

✨ 主要特性

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

📦 安裝指南

手動安裝

pip install mysql-mcp-server

通過 Smithery 安裝

要自動為 Claude 桌面安裝 MySQL MCP 服務器，請使用 Smithery：

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

📚 詳細文檔

配置

設置以下環境變量：

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

使用方法

與 Claude 桌面配合使用

將以下內容添加到你的 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"
      }
    }
  }
}

使用 MCP 檢查工具進行調試

雖然 MySQL MCP 服務器設計上不用於直接從命令行運行，但你可以使用 MCP 檢查工具進行調試：

# 安裝依賴項
pip install -r requirements.txt
# 使用 MCP 檢查工具進行調試（請勿直接用 Python 運行）

MySQL MCP 服務器專為與 AI 應用程序（如 Claude 桌面）集成而設計，不應作為獨立的 Python 程序運行。

開發

# 克隆倉庫
git clone https://github.com/yourusername/mysql_mcp_server.git
cd mysql_mcp_server
# 創建虛擬環境
python -m venv venv
source venv/bin/activate  # 或 `venv\Scripts\activate` 在 Windows 上
# 安裝開發依賴項
pip install -r requirements-dev.txt
# 運行測試
pytest

安全注意事項

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

安全最佳實踐

此 MCP 實現需要數據庫訪問權限才能運行。為了安全起見：

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

請參閱 MySQL 安全配置指南 瞭解詳細說明：

• 創建受限的 MySQL 用戶
• 設置適當的權限
• 監控數據庫連接
• 其他安全措施