🦀 TelosDB (Tauri 2 Edition)

SQLite と Rust で構築された、ローカル向けベクトル検索サーバー & DBブラウザ

📝 イントロダクション

Model Context Protocol (MCP) に準拠した、ローカル実行用のベクトル検索サーバーです。Tauri v2 および Rust をベースに構築されています。

Gemma 3 300M Embedding モデルや llama-server をサイドカーとして利用することで、外部ネットワークに依存せず、ローカル環境のみでテキストのベクトル化と検索を行うことができます。

また、内蔵の SQLite DBブラウザ により、GUI上で直接テーブル構成やデータの確認が可能です。

🏗️ システム構造

graph TD
    subgraph "Frontend Layer (WebView2)"
        UI["DB Browser & Status UI"]
    end
    
    subgraph "Tauri Backend Layer (Rust)"
        Axum["MCP Server (SSE/JSON-RPC)"]
        Tray["System Tray Manager"]
        Sidecar["Sidecar Manager"]
        ORM["SeaORM Layer"]
        Llama["Llama API Client"]
        DBCmd["DB Browser Commands"]
    end
    
    subgraph "External Process Layer"
        LS["llama-server.exe (Sidecar)"]
    end
    
    subgraph "Data Layer"
        DB[("SQLite + sqlite-vector")]
        Model["Gemma 3 300M (GGUF)"]
    end
    
    UI <--> Axum
    UI <--> DBCmd
    DBCmd <--> DB
    Axum <--> ORM
    ORM <--> DB
    Llama <--> LS
    Sidecar --> LS
    LS --> Model

⚙️ ネイティブモジュール (DLL) について

Windows 環境での動作安定性のため、ベクトル検索エンジン sqlite-vector は独自のビルド構成をとっています。

• bin/vector.dll: ベクトル検索関数を提供。
• bin/sqlite3.dll: 拡張機能のシンボル解決に必要な SQLite ライブラリ。

実行時にこれらの DLL が正しくロードされるよう、アプリケーションは起動時に bin/ をプロセスの PATH に動的に追加します。詳細は docs/sqlite-vector-build.md を参照してください。

✨ 主な機能

1. Tauri v2 + Rust: 軽量で高速なバックエンド基盤。
2. SQLite + sqlite-vector: 仮想テーブル不要。通常のテーブルの BLOB カラムにベクトルデータを保存。
3. DBブラウザ: テーブル一覧、スキーマ表示、データ閲覧（ページネーション対応）が可能なモダンなGUI。
4. MCP 準拠: SSE プロトコルにより、外部エージェント（Claude 等）からのツール呼び出しに対応。
5. Sidecar LLM: llama-server を内蔵し、オフラインでのテキスト処理が可能。
6. SeaORM: 型安全なデータベース操作。
7. 長文対応: 入力テキストの自動チャンキングと Mean Pooling により、コンテキスト制限を超える文書もベクトル化可能。

📁 ディレクトリ構成

.
├── .agent/       # エージェント用ルール・ドキュメント
├── bin/          # 外部バイナリ (llama-server, vector.dll等)
├── data/         # データベースファイル (vector.db)
├── docs/         # 仕様・設計ドキュメント
├── journals/     # 開発記録 (Git管理外)
├── logs/         # アプリケーションログ
├── resources/    # アセット類
├── scripts/      # ユーティリティスクリプト
├── src-backend/  # Rust / Tauri バックエンド
├── src-frontend/ # Webview UI
├── tests/        # テストコード
└── tmp/          # 一時ファイル (ソースビルド用ワークスペース等)

🛠️ MCP ツール

📜 ライセンス

ISC License.