Mineru98 Mysql MCP Server

🚀 mysql - mcp服務器

本項目提供了一個mysql - mcp服務器，可通過Docker或Python直接運行，具備豐富的數據庫操作執行器，同時給出了安全使用的相關注意事項。

🚀 快速開始

本項目提供了兩種運行方式，你可以根據自己的需求進行選擇。

📦 使用Docker運行

# 啟動數據庫容器
docker-compose up -d db

# 構建並啟動mysql-mcp-server（包括重建）
docker-compose up -d --build mysql-mcp-server

📦 直接使用Python運行

# 設置環境變量文件
cp .env.example .env

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

# 運行服務器
python mysql_mcp_server/main.py run

📚 詳細文檔

項目結構

MCPBoilerPlate/
├── mysql_mcp_server/           # 主應用目錄
│   ├── executors/              # 數據庫操作執行器
│   │   ├── create_table.py     # 創建表工具
│   │   ├── desc_table.py       # 查看錶結構工具
│   │   ├── explain.py          # 查詢執行計劃工具
│   │   ├── insert_query.py     # 執行INSERT查詢工具
│   │   ├── insight_starter.py  # 寫報告的架構驗證工具
│   │   ├── invoke_viz_pro.py   # 可視化圖表推薦工具
│   │   ├── select_query.py     # 執行SELECT查詢工具
│   │   └── show_tables.py      # 獲取表列表工具
│   ├── helper/                 # 工具模塊
│   │   ├── db_conn_helper.py   # 數據庫連接管理工具
│   │   ├── logger_helper.py    # 日誌記錄工具
│   │   └── tool_decorator.py   # 工具裝飾器
│   └── main.py                 # 應用入口點
├── docker-compose.yml          # Docker Compose配置文件
├── Dockerfile                  # Docker鏡像構建設置
├── requirements.txt            # 依賴項列表
└── .env.example                # 環境變量示例文件

⚠️ 安全注意事項

⚠️ 重要提示

• 使用環境變量管理數據庫憑證。
• 生產環境中使用強密碼。
• 必要時考慮為數據庫連接實施SSL/TLS加密。