hebbian-vault

hebbian-vault

インテリジェントで利用状況に適応する Obsidian vault 検索の MCP サーバーです。

vault は重要なものを記憶します。使用するファイルは強化され、使用しないファイルは薄れていきます。ハブページが先に表示されます。検索は時間とともに改善します。

できること

キーワード照合を行う標準の Obsidian 検索とは異なり、hebbian-vault は Reciprocal Rank Fusion を使って、4 つのシグナルを統合します。

• BM25 -- キーワードの関連性（標準の検索と似ていますが、順位付けされます）
• Personalized PageRank -- クエリに応じて重み付けされたグラフ中心性（ハブページが先に表示されます）
• Hebbian usage -- 実際に使用するファイルを、最近の使用状況による減衰を加味して上位に表示します
• RRF merge -- 重みの調整なしで、すべてのシグナルを統合します

あらゆる Obsidian vault で動作します。クラウドは不要です。Obsidian の起動も不要です。ファイルシステムに直接アクセスします。

インストール

pip install hebbian-vault

使い方

Claude Code

claude mcp add hebbian-vault -- hebbian-vault --vault ~/my-vault

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "hebbian-vault": {
      "command": "uvx",
      "args": ["hebbian-vault", "--vault", "/path/to/vault"]
    }
  }
}

直接実行

hebbian-vault --vault ~/my-vault

MCP ツール

ツール	説明
configure_vault	実行時にサーバーの接続先 vault を指定します（--vault で設定されていない場合）
vault_search	ハイブリッド検索で順位付けします（BM25 + PageRank + Hebbian）
vault_read	フロントマター、リンク、Hebbian メタデータを含むノートを読み込みます
vault_neighbors	wikilink を使って関連するノートを検索します（1 ホップまたは 2 ホップ）
vault_hot	Hebbian スコアに基づき、使用頻度が最も高いファイルを N 件表示します
vault_stats	vault の分析情報（ファイル、リンク、孤立ファイル、ハブ）を表示します
vault_health	構造の整合性を確認します（リンク切れ、孤立ファイル）

Hebbian 学習の仕組み

vault_search または vault_read がファイルを返すたびに、そのファイルの取得回数が増加します。最近アクセスしたファイルには、最近の使用状況によるブーストが加わります。数週間アクセスされていないファイルは減衰します。時間とともに vault に「ヒートシグネチャー」が形成され、よく役立つファイルは強化され、あまり役立たないファイルは薄れていきます。

これは、情報検索に Hebbian learning を応用したものです。「共に発火するニューロンは、共に結び付く」。vault は実際の使い方に適応します。

ストレージ

既定では、追跡データは vault 内のサイドカーディレクトリ .hebbian/ に保存されます。Markdown ファイルは変更されません。

Pro ユーザーは --inline-tracking を有効にすると、retrieval_count を YAML フロントマターに直接書き込めます（Obsidian でそのまま表示でき、Dataview でクエリできます）。

Pro プラン

無料プランでも、ほとんどの用途に必要な機能をすべて利用できます。Pro では、上級ユーザー向けの便利な機能が使えるようになります。

• --inline-tracking — サイドカーファイルの代わりに、ノートのフロントマターに取得回数を書き込みます
• 開発者による優先メールサポート
• 今後のプレミアム機能は、既定で Pro で利用できます

ライセンスの有効化 — 次のいずれか 1 つで有効化できます。

# 1. Environment variable (good for shell profiles)
export HEBBIAN_VAULT_LICENSE="eyJhbGc..."

# 2. CLI flag (good for one-off testing)
hebbian-vault --license-key "eyJhbGc..." --vault ~/my-vault

# 3. Config file (good for permanent install)
echo "eyJhbGc..." > ~/.hebbian-vault/license.jwt

ライセンスの検証は完全にオフラインで行われます。ホームサーバーへの接続も、アクティベーションサーバーもありません。ライセンスの入手先：[まもなく公開 — Dodo Payments のストアフロントを検証中]。

オプション

hebbian-vault --vault PATH          Path to Obsidian vault
              --inline-tracking     [Pro] Write tracking to file frontmatter
              --license-key KEY     Pro license JWT (also reads HEBBIAN_VAULT_LICENSE env)
              --transport TYPE      stdio (default) or streamable-http
              --port PORT           Port for HTTP transport (default: 8000)

必要条件

• Python 3.10+
• Obsidian vault（サイズは問いません。グラフ機能には wikilink を推奨します）

ライセンス

MIT