{
  "markdown": "<!-- mcp-name: io.github.onetrueclaude-creator/hebbian-vault -->\n\n# hebbian-vault\n\n**MCP server for intelligent, use-adaptive Obsidian vault search.**\n\nYour vault remembers what matters. Files you use strengthen. Unused files fade. Hub pages surface first. Search gets better over time.\n\n## What it does\n\nUnlike standard Obsidian search (keyword matching), hebbian-vault uses four signals merged via [Reciprocal Rank Fusion](https://plg.uwaterloo.ca/~gvcormac/cormacksigir09-rrf.pdf):\n\n- **BM25** -- keyword relevance (like standard search, but ranked)\n- **Personalized PageRank** -- graph centrality biased toward your query (hub pages surface first)\n- **Hebbian usage** -- files you actually use rank higher, with recency decay\n- **RRF merge** -- combines all signals without weight tuning\n\nWorks with any Obsidian vault. No cloud. No Obsidian running required. Direct filesystem access.\n\n## Install\n\n```bash\npip install hebbian-vault\n```\n\n## Usage\n\n### Claude Code\n```bash\nclaude mcp add hebbian-vault -- hebbian-vault --vault ~/my-vault\n```\n\n### Claude Desktop\nAdd to `claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"hebbian-vault\": {\n      \"command\": \"uvx\",\n      \"args\": [\"hebbian-vault\", \"--vault\", \"/path/to/vault\"]\n    }\n  }\n}\n```\n\n### Direct\n```bash\nhebbian-vault --vault ~/my-vault\n```\n\n## MCP Tools\n\n| Tool | Description |\n|------|-------------|\n| `configure_vault` | Point the server at a vault at runtime (if not set via `--vault`) |\n| `vault_search` | Hybrid ranked search (BM25 + PageRank + Hebbian) |\n| `vault_read` | Read a note with frontmatter, links, and Hebbian metadata |\n| `vault_neighbors` | Find connected notes by wikilinks (1-hop or 2-hop) |\n| `vault_hot` | Top-N most-used files by Hebbian score |\n| `vault_stats` | Vault analytics (files, links, orphans, hubs) |\n| `vault_health` | Structural integrity check (broken links, orphans) |\n\n## How Hebbian learning works\n\nEvery time `vault_search` or `vault_read` returns a file, that file's retrieval count increments. Files accessed recently get a recency boost. Files untouched for weeks decay. Over time, the vault develops a \"heat signature\" -- frequently useful files strengthen, rarely useful files fade.\n\nThis is [Hebbian learning](https://en.wikipedia.org/wiki/Hebbian_theory) applied to information retrieval: \"neurons that fire together wire together.\" Your vault adapts to how you actually use it.\n\n## Storage\n\nBy default, tracking data is stored in a `.hebbian/` sidecar directory inside your vault. Your markdown files are not modified.\n\nPro users can enable `--inline-tracking` to write `retrieval_count` directly into YAML frontmatter (visible natively in Obsidian, queryable via Dataview).\n\n## Pro tier\n\nThe free tier is fully featured for most use. Pro unlocks convenience features for power users:\n\n- `--inline-tracking` — write retrieval counts into note frontmatter instead of sidecar files\n- Priority email support from the developer\n- Future premium features ship Pro-unlocked by default\n\nLicense activation — any one of these works:\n\n```bash\n# 1. Environment variable (good for shell profiles)\nexport HEBBIAN_VAULT_LICENSE=\"eyJhbGc...\"\n\n# 2. CLI flag (good for one-off testing)\nhebbian-vault --license-key \"eyJhbGc...\" --vault ~/my-vault\n\n# 3. Config file (good for permanent install)\necho \"eyJhbGc...\" > ~/.hebbian-vault/license.jwt\n```\n\nLicenses are verified fully offline — no phone-home, no activation server. Get a license: **[coming soon — Dodo Payments storefront in verification]**.\n\n## Options\n\n```\nhebbian-vault --vault PATH          Path to Obsidian vault\n              --inline-tracking     [Pro] Write tracking to file frontmatter\n              --license-key KEY     Pro license JWT (also reads HEBBIAN_VAULT_LICENSE env)\n              --transport TYPE      stdio (default) or streamable-http\n              --port PORT           Port for HTTP transport (default: 8000)\n```\n\n## Requirements\n\n- Python 3.10+\n- An Obsidian vault (any size, wikilinks recommended for graph features)\n\n## License\n\nMIT\n",
  "bytes": 4022,
  "sha": "3f05ca07b9dc72fc6399a4a4fddb016597499931e7102a1cfc6329b5969a1529",
  "repo_slug": "onetrueclaude-creator/hebbian-vault",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_onetrueclaude_creator_hebbian__1438697e/readme"
}