Mysql MCP Server Sse

🚀 MySQL查詢服務器

MySQL查詢服務器是一個基於Python和MySQL數據庫構建的應用程序，它提供了一套完整的工具和服務，可執行各類MySQL查詢操作，涵蓋基礎查詢、元數據檢索、數據庫信息獲取以及表結構高級操作等，為數據庫操作帶來了極大便利。

🚀 快速開始

安裝步驟

1. 克隆項目倉庫到本地。
2. 安裝依賴項（參見requirements.txt）。
3. 配置環境變量（使用.env.example作為模板）。
4. 啟動服務器。

啟動命令

python src/server.py

默認運行地址為 http://127.0.0.1:3000/sse

✨ 主要特性

• 高性能：優化了MySQL連接池和查詢執行效率，支持高併發訪問。
• 安全性：內置SQL攔截器和安全檢查機制，防止惡意攻擊和未授權操作。
• 可擴展性：模塊化設計，方便添加新的查詢類型和功能插件。
• 易用性：提供清晰的文檔和友好的交互界面，簡化數據庫操作流程。

📦 安裝指南

配置要求

• Python版本：3.8及以上
• MySQL Connector：支持的MySQL連接器庫
• 環境變量：配置數據庫連接信息和安全參數

📚 詳細文檔

項目結構

.
├── src/                     # 源代碼目錄
│   ├── server.py           # 主服務器文件
│   ├── db/                 # 數據庫相關代碼
│   │   └── mysql_operations.py # MySQL操作實現
│   ├── security/           # SQL安全相關代碼
│   │   ├── interceptor.py   # SQL攔截器
│   │   ├── query_limiter.py # SQL安全檢查器
│   │   └── sql_analyzer.py  # SQL分析器
│   └── tools/              # 工具類代碼
│       ├── mysql_tool.py           # 基礎查詢工具
│       ├── mysql_metadata_tool.py  # 元數據查詢工具
│       ├── mysql_info_tool.py      # 數據庫信息查詢工具
│       ├── mysql_schema_tool.py    # 表結構高級查詢工具
│       └── metadata_base_tool.py   # 元數據工具基類
├── tests/                  # 測試代碼目錄
├── .env.example            # 環境變量示例文件
└── requirements.txt        # 項目依賴文件

安全機制

• 風險級別控制：通過ALLOWED_RISK_LEVELS環境變量限制允許的操作風險級別。
• 敏感信息保護：生產環境下默認隱藏敏感數據，開發環境中可啟用ALLOW_SENSITIVE_INFO以顯示敏感信息。

常見問題解決

DELETE操作未執行成功

1. 檢查DELETE語句是否包含WHERE條件。
2. 確保操作的風險級別在允許範圍內（如需執行高風險操作，請調整環境變量）。
3. 查看影響行數，確認操作是否生效。

環境變量未生效

• 確保load_dotenv()調用位於其他模塊導入之前。
• 重啟應用以加載新配置。

日誌系統

支持多種日誌記錄格式和級別，便於調試和監控。默認輸出到控制檯和文件。

📄 許可證

本項目遵循MIT License協議。
版權聲明：© [Your Name] 或公司名稱。
使用條款：允許自由複製、修改和分發代碼，但需保留版權聲明。

如需進一步瞭解，請參考項目文檔或聯繫維護人員。