Newer
Older
TelosDB / README.md

TelosDB

ローカル完結型セマンティック検索DB & MCPサーバー


概要

TelosDBは、Tauri 2 + Rust + Vanilla JS/HTMLで構成された、SQLite Vector拡張を活用するローカル特化型セマンティック検索基盤です。 サイドカー(llama-server)による高品質な埋め込み生成、Model Context Protocol (MCP) 準拠のSSEサーバー、そしてガラスモーフィズムを採用したプレミアムなUIを備えています。

外部APIを一切使用せず、ローカルLLM(Gemma-3)の力を借りて、安全かつ高速な知識検索環境をデスクトップに提供します。


主な機能

  • セマンティック検索 (Vector Search): sqlite-vec を用いた高精度な意味検索。
  • 内蔵推論エンジン (Sidecar Integration): llama-server を自動管理。アプリ起動と同時に推論サーバーが立ち上がります。
  • MCP SSE サーバー仕様: SSE (Server-Sent Events) を用いた非同期レスポンス方式を採用。LM Studio, Claude Desktop などの外部AIツールから「プラグイン」として直接接続可能です。
  • プレミアム・デザイン: ガラスモーフィズムを基調とした洗練されたUI。ステータスインジケーターにより推論エンジンの稼働状況を一目で把握できます。
  • 堅牢なロギング: ローテーション機能付きログ出力。llama-server の詳細な内部ログもキャプチャします。

セットアップ

1. 動作要件

  • OS: Windows 10/11 (x64)
  • Rust: 1.77.2以上
  • Node.js / Bun: 最新のLTS推奨

2. モデルの配置

以下のパスに GGUF モデルファイルを配置してください: src-tauri/bin/gemma-3-270m-it-Q4_K_M.gguf

3. 起動方法

# 依存関係のインストール
bun install

# 開発モードで実行
bun run tauri dev

システム構造

graph TD
    subgraph "Frontend (Vanilla JS)"
        UI[Glassmorphism UI]
        SSE_Monitor[SSE Client]
    end

    subgraph "Backend (Rust/Tauri)"
        Main[Tauri Core]
        Axum[Axum MCP Server]
        DB[(SQLite + sqlite-vec)]
        Logger[Rotating Logger]
    end

    subgraph "Sidecar (llama-server)"
        Engine[Inference Engine]
        Model[Gemma-3 GGUF]
    end

    UI <-- JSON / SSE --> Axum
    Axum <-- SQL/Vector --> DB
    Main -- Spawn/Monitor --> Engine
    Engine -- Load --> Model
    Engine -- Log Stream --> Logger

開発者向け情報

ログ

ログファイルは以下に出力されます:

  • 開発時: src-tauri/logs/telos.log
  • 実行時: %LOCALAPPDATA%/com.telosdb.app/logs/telos.log

MCP接続設定

UI上の「MCP Config」ボタンをクリックすると、LM Studio 等に貼り付け可能な設定 JSON が表示されます。


ライセンス

MIT License