Puchaczov/Musoq

何を解決するか

Musoq は、データのインジェストや中間保存を必要とせずに、ログファイル、git の履歴、バイナリダンプ、システムプロセスなどの非データベースデータソースに対して、アドホックな SQL クエリを実行する方法を提供します。脆弱な Bash コマンドチェーンやカスタムスクリプトの代わりに、迅速なデータ調査やデバッグのために宣言型の SQL クエリを使用できます。

動作方法

Musoq は、データソースから直接ストリーミングおよび変換を行うモジュール式の SQL エンジンです。標準 SQL を拡張し、非構造化データを扱うための特別なプリミティブを提供しています：

• インラインバイナリデコード：クエリ内で直接構造体（structs）を宣言することで、ファイルからの生のバイト列を解析できます。
• 宣言型テキストパース：テキストファイルから構造化フィールドを抽出するために、ログフォーマットをインラインで記述できます。
• 強力な型システム：couple ステートメントにより、LLM からの抽出結果などの型のないデータを厳密な SQL テーブルにバインドできます。
• データソース：OS ファイルシステム、Git リポジトリ、Docker、Kubernetes、LLM API（OpenAI/Ollama）など、さまざまなソースに接続するためのプラグインアーキテクチャを使用しています。

対象ユーザー

データベースのセットアップや一時的なスクリプトの作成のオーバーヘッドなしに、ローカルファイルやシステム状態に対して複雑な調査を行う必要がある開発者やシステム管理者。

特徴

• ゼロインジェスト：データをデータベースにインポートせずに、データが存在する場所から直接クエリを実行。
• 高度な SQL サポート：再帰的 CTE と相関サブクエリを含む。
• uma stdin パイプ：SQL を使用してストリーミングされた stdin データをネイティブにクエリ可能。
• AIエージェント統合：Claude や Cursor などの AI アシスタント向けに、保存されたクエリをツールとして公開するための組み込み Model Context Protocol (MCP) サーバー。
• 柔軟なパース：SQL スクリプト内にインラインでバイナリおよびテキストスキーマを定義可能。