Puchaczov/Musoq

解決的問題

Musoq 提供了一種無需資料攝入或中間儲存，即可對非資料庫資料來源（如日誌檔案、git 歷史、二進位轉儲和系統程序）執行即席 SQL 查詢的方法。它以宣告式 SQL 查詢取代脆弱的 Bash 命令鏈或自訂腳本，實現快速的資料調查與除錯。

工作原理

Musoq 是一個模組化的 SQL 引擎，可直接從資料來源串流與轉換資料。它擴展了標準 SQL，增加了處理非結構化資料的專用原語：

• 內嵌二進位解碼：使用者可在查詢中直接宣告二進位結構（structs），以解析檔案中的原始位元組。
• 宣告式文字解析：使用者可內嵌描述日誌格式，從文字檔案中提取結構化欄位。
• 強型別系統：couple 陳述式允許將無型別資料（如 LLM 提取結果）綁定至嚴格的 SQL 表中。
• 資料來源：採用外掛架構，支援連接到各種來源，如作業系統檔案系統、Git 倉儲、Docker、Kubernetes 以及 LLM API（OpenAI/Ollama）。

適用對象

需要在不設定資料庫或撰寫一次性腳本的情況下，對本機檔案或系統狀態進行複雜調查的開發者與系統管理員。

主要亮點

• 零攝入：直接在資料所在位置查詢，無需將資料導入資料庫。
• 高階 SQL 支援：支援遞迴 CTE 與相關子查詢。
• uma stdin 管道：原生支援使用 SQL 查詢串流 stdin 資料。
• AI 助手整合：內建 Model Context Protocol (MCP) 伺服器，可將儲存的查詢作為工具暴露給 Claude 或 Cursor 等 AI 助手。
• 靈活解析：可在 SQL 腳本中內嵌定義二進位與文字模式。