apache/doris-mcp-server

解決的問題

允許 AI 代理與 MCP（模型上下文協定）主機以安全、唯讀方式與 Apache Doris 資料庫互動。透過為代理提供結構化的方式來發現與執行資料庫操作，彌補 LLM 與複雜資料庫功能之間的差距，同時不授予其完整的管理存取權限。

工作原理

伺服器實作 MCP 協定，將 Apache Doris 功能作為一組工具公開。它使用階層式發現系統，代理首先呼叫一個「領域」（如 doris_query 或 doris_cluster）來發現特定的子功能及其結構。支援多種傳輸方式，包括 stdio 與 Streamable HTTP，並強制執行嚴格的安全邊界，其中 Doris RBAC（基於角色的存取控制）是資料可見性的最終權威。

適用對象

需要查詢、監控或分析儲存在 Apache Doris 中的資料的 AI 代理開發者，或使用 MCP 相容主機的開發者。

主要亮點

• 階層式工具設計：將 55 個子功能組織成 8 個穩定的領域（例如 catalog、query、cluster、pipeline、search、governance、lakehouse 與 semantic）。
• 唯讀安全：內建唯讀目錄，防止意外或惡意的資料修改。
• 企業級安全：支援 JWT、OAuth/OIDC 與 Doris 支援的 OAuth，敏感資訊與錯誤訊息皆會隱藏。
• 詳細可觀測性：提供叢集指標、慢查詢診斷與資料血緣追蹤功能。
• 彈性部署：支援本地 stdio 與網路導向的 HTTP 傳輸。