vault-index
Local hybrid search for markdown vaults and codebases, served as an MCP server. Keyword search (SQLite FTS5) and vector search (sqlite-vec, bge-small-en-v1.5 on CPU) are merged with reciprocal rank fusion. Everything lives in one SQLite file on your machine; no cloud services.
Part of claude-second-brain, where every search change is measured against golden question sets and compared with naive grep and basic-memory (see its README for the numbers).
Use with Claude Code
claude mcp add vault-index -- uvx --python 3.12 vault-index
Then ask Claude to index a folder, for example: "index_paths ~/notes". After that, search_notes finds paraphrased answers with file path and heading. The first run downloads the embedding model (about 65 MB).
Tools
index_paths(paths, reindex=False): add folders or files as sources and sync them. With no paths, re-syncs every source (new, changed and deleted files).search_notes(query, limit=8, path_prefix=None): hybrid search; returns chunks with file path and heading path.get_note(path): full text of an indexed file.list_sources(),remove_source(path).
Markdown is chunked by heading. A .indexignore in a source folder lists relative paths to skip.
Settings
| Env var | Default |
|---|---|
VAULT_INDEX_DB |
~/.mcp-memory/vault-index.db |
VAULT_MODEL_CACHE |
~/.mcp-memory/models |
Python 3.10 to 3.13 (--python 3.12 keeps uvx off newer Pythons that onnxruntime does not support yet). MIT license.
1 maintainer
Metadata
1 maintainer
Release files for vault-index 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| vault_index-0.2.0.tar.gz | 7.7 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vault_index-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 15.9 kB
Release files / vault_index-0.2.0.tar.gz
| Download URL | vault_index-0.2.0.tar.gz |
|---|---|
| Size | 7.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2b94065cc55bf24c74f652117a01afb3d8ff366bbf7c0db16041905f99d9f775
|
|
BLAKE2b-256 checksum How to use checksums |
7b9d7753bbc4095d19a6b668fbd5ee7952494982d8be97f2065b744e016a70dc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logRelease files / vault_index-0.2.0-py3-none-any.whl
| Download URL | vault_index-0.2.0-py3-none-any.whl |
|---|---|
| Size | 8.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
56d4bc70c00c237d79a5b7bee8a56a92573bcb1e5ecaaa66feee3534d5edd7d2
|
|
BLAKE2b-256 checksum How to use checksums |
1cbcfde2979b296c7aff808737a5918b95555a223953819558749fb70e9c84e0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logSecurity for vault-index 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for vault_index-0.2.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
