Oracle V2

🚀 Oracle Nightly - MCP Memory Layer

「オラクルは人間を人間たらしめる」 - 現在、MCPを介してクエリ可能です

オラクル哲学に関する意味検索用のTypeScript MCPサーバーです。SQLite FTS5とChromaDBを組み合わせたハイブリッド検索、HTTP API、およびボールトCLIを備えています。

🚀 クイックスタート

このソフトウェアは、オラクル哲学に関する意味検索を行うためのTypeScript MCPサーバーです。SQLite FTS5とChromaDBを組み合わせたハイブリッド検索、HTTP API、およびボールトCLIを提供します。

✨ 主な機能

• オラクル哲学に関する意味検索を行うことができます。
• SQLite FTS5とChromaDBを組み合わせたハイブリッド検索をサポートします。
• HTTP APIを介してアクセスできます。
• ボールトCLIを使用して知識ボールトを管理できます。

📦 インストール

bunx (推奨)

GitHubを介して配布されているため、npmへの公開は必要ありません。

# MCPサーバー (stdio, for Claude Code)
bunx --bun oracle-v2@github:Soul-Brews-Studio/oracle-v2#main

# ボールトCLI (セカンダリバイナリ — --packageを使用)
bunx --bun --package oracle-v2@github:Soul-Brews-Studio/oracle-v2#main oracle-vault --help

Claude Codeに追加

claude mcp add oracle-v2 -- bunx --bun oracle-v2@github:Soul-Brews-Studio/oracle-v2#main

または、~/.claude.jsonに以下を記述します。

{
  "mcpServers": {
    "oracle-v2": {
      "command": "bunx",
      "args": ["--bun", "oracle-v2@github:Soul-Brews-Studio/oracle-v2#main"]
    }
  }
}

ソースからインストール

git clone https://github.com/Soul-Brews-Studio/oracle-v2.git
cd oracle-v2 && bun install
bun run dev          # MCPサーバー
bun run server       # :47778でHTTP APIを起動

curl -sSL https://raw.githubusercontent.com/Soul-Brews-Studio/oracle-v2/main/scripts/install.sh | bash

💻 使用例

基本的な使用法

# MCPサーバーを起動
bunx --bun oracle-v2@github:Soul-Brews-Studio/oracle-v2#main

高度な使用法

# ボールトCLIを使用して知識ボールトを管理
oracle-vault init <owner/repo>    # GitHubリポジトリでボールトを初期化
oracle-vault status               # 設定と保留中の変更を表示
oracle-vault sync                 # GitHubにコミットしてプッシュ
oracle-vault pull                 # ボールトファイルをローカルのψ/にプル
oracle-vault migrate              # ghqリポジトリからボールトをシード

📚 詳細ドキュメント

MCPツール

Claude Codeを介して22のツールが利用可能です。

APIエンドポイント

ポート47778でHTTP APIが提供されています (bun run server)。

データベース

SQLiteとDrizzle ORMを使用しています。

bun db:push       # スキーマをDBにプッシュ
bun db:generate   # マイグレーションを生成
bun db:migrate    # マイグレーションを適用
bun db:studio     # Drizzle Studio GUIを開く

プロジェクト構造

oracle-v2/
├── src/
│   ├── index.ts          # MCPサーバーエントリ
│   ├── server.ts         # HTTP API (Hono)
│   ├── indexer.ts        # 知識インデクサー
│   ├── vault/
│   │   └── cli.ts        # ボールトCLIエントリ
│   ├── tools/            # MCPツールハンドラー
│   ├── trace/            # トレースシステム
│   ├── db/
│   │   ├── schema.ts     # Drizzleスキーマ
│   │   └── index.ts      # DBクライアント
│   └── server/           # HTTPサーバーモジュール
├── scripts/              # セットアップとユーティリティスクリプト
├── docs/                 # ドキュメント
└── drizzle.config.ts     # Drizzle設定

設定

テスト

bun test              # すべてのテスト
bun test:unit         # 単体テスト
bun test:integration  # 統合テスト
bun test:e2e          # Playwright E2Eテスト
bun test:coverage     # カバレッジ付き

🔧 技術詳細

アーキテクチャ

oracle-v2 (one package, two bins)
├── bunx oracle-v2                          → MCP server (src/index.ts)
├── bunx --package oracle-v2 oracle-vault   → Vault CLI (src/vault/cli.ts)
├── bun run server                          → HTTP API (src/server.ts)
└── bun run index                           → Indexer (src/indexer.ts)

oracle-studio (separate repo)
└── bunx oracle-studio                      → React dashboard

スタック

• Bun ランタイム (>=1.2.0)
• SQLite + FTS5による全文検索
• ChromaDB によるベクトル/意味検索
• Drizzle ORM による型安全なクエリ
• Hono によるHTTP API
• MCP プロトコルによるClaude統合

📄 ライセンス

このREADMEにはライセンス情報が含まれていないため、このセクションは表示されません。

参考文献

• TIMELINE.md - 完全な進化履歴
• docs/API.md - APIドキュメント
• docs/architecture.md - アーキテクチャの詳細
• Drizzle ORM
• MCP SDK

謝辞

Alex Newmanによるclaude-memに触発されています。プロセスマネージャーパターン、ワーカーサービスアーキテクチャ、およびフックシステムの概念に影響を受けています。