hs-sql-agent

快速部署一套內建管理面板的 關聯式資料庫 HTTP MCP 伺服器。 hs-sql-agent 可讓 Claude Desktop、Cursor、Visual Studio Code 等 MCP 用戶端安全地存取關聯式資料庫，同時讓管理員集中管理資料庫連線、MCP 金鑰、權限、稽核紀錄與安全性政策。 此 Zeabur 範本會自動部署：

• hs-sql-agent — MCP 伺服器與管理面板
• PostgreSQL — 內部管理資料庫
• Redis — 快取、速率限制、並行控制與安全性政策同步

✨ 功能特色

• 🔌 HTTP MCP Endpoint
• 🔑 每個用戶端獨立的 MCP Access Key
• 🗄️ 多資料庫連線管理
• 🔐 每個 MCP Key 可獨立綁定資料庫
• 🧰 每個 MCP Key 可獨立設定工具權限
• 🚦 可設定 Rate Limit
• 📋 SQL 執行稽核紀錄
• 🛡️ 集中式安全性政策
• ⚡ 基於 Redis 的快取與並行控制
• 🖥️ 內建 Web 管理面板
• 📋 可直接複製使用的 MCP Client 設定

🚀 快速開始

1. 部署範本

在 Zeabur 部署此範本，並替管理面板設定一個子網域。 Zeabur 會自動建立並連接所有必要服務。 部署完成後，開啟 Zeabur 部署說明中顯示的 Admin Panel URL。

2. 建立管理員帳號

第一次啟動時，需要建立第一個管理員帳號。 建立完成後，使用該帳號登入管理面板。

3. 新增資料庫

進入 DB Management，新增你希望 MCP 用戶端可以存取的關聯式資料庫。 建議在簽發 MCP Key 前先測試資料庫連線。

4. 簽發 MCP Access Key

進入： Runtime Admin → MCP Keys 建立新的 MCP Key，並設定對應的存取權限。 可設定的項目包含：

• Key 名稱
• 到期時間
• 資料庫
• Rate Limit
• 允許使用的 MCP Tools
• 選用的資料存取限制
• 選用的 CORS Origins 先點擊 Test DB Connection 確認所選資料庫可以正常連線，再點擊 Issue Key。

5. 複製 MCP 設定

MCP Key 簽發成功後，hs-sql-agent 會立即顯示 Save and connect 視窗。 其中會直接提供：

• 僅顯示一次的 MCP Key
• MCP Endpoint
• 已產生好的 MCP Client 完整設定 選擇你使用的 MCP Client：
• Claude Desktop
• Cursor
• Visual Studio Code
• Generic HTTP 接著點擊對應的 Copy config 按鈕，將設定直接貼到 MCP Client 即可。

⚠️ MCP Key 的明文只會顯示一次。 > > 關閉視窗前，請先保存 MCP Key，或直接複製已產生好的 Client 設定。視窗關閉後，將無法再從 Admin UI 查看此 Key 的明文內容。 完成。你不需要再手動組合 MCP Endpoint 或 Authentication Header。

🔐 安全性建議

請將 MCP Key 視為密碼等級的敏感資訊。 請勿將包含 MCP Key 的設定提交到 Git Repository，也不要貼到公開 Issue、Ticket 或其他公開位置。 如果 MCP Key 不慎外洩，請前往 MCP Keys 頁面撤銷該 Key，並重新簽發新的 Key。 正式環境的資料庫建議使用專用資料庫帳號，並遵循最小權限原則，只提供實際 MCP Tools 所需的資料庫權限。

⚠️ 專案狀態

hs-sql-agent 目前仍處於 積極開發階段。 不同版本之間的功能與設定可能有所變更，也可能仍存在 Bug。 如果遇到問題或有功能建議，歡迎透過以下管道提出：

• 🔗 GitHub Issues
• ⭐ GitHub Repository