Crate claude_hippo 

claude-hippo — Claude Code に海馬を足す MCP サーバ。

全部覚える代わりに、特異性が高い瞬間だけを長期記憶化する surprise-aware memory store。schema は mcp-memory-service-rs と互換 (SHODH spec 準拠)、 ライセンスは Apache-2.0 / MIT dual。

構成

• storage: SQLite + sqlite-vec の記憶ストア (mcp-memory-service-rs 互換 schema)
• embeddings: fastembed (all-MiniLM-L6-v2, 384 dim, L2 normalized)
• surprise: surprise score 算出 (embedding outlier + engagement + explicit)
• server: rmcp で MCP stdio server (5 hippo_* tools + SHODH alias)
• cli: clap CLI (serve / verify / embed / bench)

Re-exports

pub use error::HippoError;

pub use error::Result;

Modules

cli

CLI — clap derive。serve / verify / embed / bench。

embeddings

Embedding layer.

error

claude-hippo の統一エラー型。

memory_tool

Anthropic Memory Tool compatibility layer.

prediction_loss

Prediction-loss backend — fills SurpriseComponents.prediction_loss.

server

MCP server (rmcp) — claude-hippo の 5 ツール + SHODH 互換エイリアス。

shodh_rest

SHODH OpenAPI v1.0.0 compatibility — REST server (v0.3, opt-in).

storage

Storage layer — SQLite + sqlite-vec, mcp-memory-service-rs と schema 互換。

surprise

Surprise scoring — claude-hippo の差別化機能の核。

Constants

EMBEDDING_DIM

埋め込み次元 (BGE-small-en-v1.5 / all-MiniLM-L6-v2 共通の 384)。 これは mcp-memory-service-rs と DB swap 互換性を保つために固定。

VERSION

このバイナリのバージョン。Cargo.toml の version を反映。