Local semantic search MCP server — notes + code, embedded Qdrant, fastembed
Project description
cortex-local
Local semantic search MCP server for Claude Code — index your notes and code, search them semantically without any server or cloud dependency.
Install
pipx install cortex-local
cortex install
cortex install downloads embedding models and registers the MCP server in Claude Code. Restart Claude Code after.
Usage
cortex index ~/notes # index Obsidian vault
cortex index ~/projects/myapp # index a code repo
Then in Claude Code, search_notes and search_code are available as MCP tools.
How it works
- Embeddings: fastembed (
nomic-embed-text-v1.5) + BM25 sparse — runs fully local, no GPU needed - Vector store: embedded Qdrant at
~/.cortex/qdrant - Graph layer: import graph with degree centrality re-ranking + Personalized PageRank for notes
Full documentation: github.com/Xoudusz/cortex
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cortex_local-2.0.3.tar.gz.
File metadata
- Download URL: cortex_local-2.0.3.tar.gz
- Upload date:
- Size: 9.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
eeb06b7c0f314c3422c7115eb50a0d3c499d4768d10ead5fbffc830c33fea06b
|
|
| MD5 |
d6a45f64029c54d9dd1531220381732e
|
|
| BLAKE2b-256 |
0a8f11cc0fb425c582458c7773fc4ba8ef8c499f5acd3524879950ad74499b91
|
Provenance
The following attestation bundles were made for cortex_local-2.0.3.tar.gz:
Publisher:
deploy.yml on Xoudusz/cortex
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cortex_local-2.0.3.tar.gz -
Subject digest:
eeb06b7c0f314c3422c7115eb50a0d3c499d4768d10ead5fbffc830c33fea06b - Sigstore transparency entry: 1789842045
- Sigstore integration time:
-
Permalink:
Xoudusz/cortex@91836056ac3c28b550b17e9fdcb8c380ffbbd76b -
Branch / Tag:
refs/heads/main - Owner: https://github.com/Xoudusz
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
deploy.yml@91836056ac3c28b550b17e9fdcb8c380ffbbd76b -
Trigger Event:
push
-
Statement type:
File details
Details for the file cortex_local-2.0.3-py3-none-any.whl.
File metadata
- Download URL: cortex_local-2.0.3-py3-none-any.whl
- Upload date:
- Size: 12.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c80719ba49e148f8d503c2cf6f63a95270b92cfabe11d0c66d72433b6c15c150
|
|
| MD5 |
686f335a0c9eeef478ffb65f4fc44a3b
|
|
| BLAKE2b-256 |
31305353e739b129ba1e30cceae8a6fae2270f1b28a005bc491505aefcd42758
|
Provenance
The following attestation bundles were made for cortex_local-2.0.3-py3-none-any.whl:
Publisher:
deploy.yml on Xoudusz/cortex
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cortex_local-2.0.3-py3-none-any.whl -
Subject digest:
c80719ba49e148f8d503c2cf6f63a95270b92cfabe11d0c66d72433b6c15c150 - Sigstore transparency entry: 1789842056
- Sigstore integration time:
-
Permalink:
Xoudusz/cortex@91836056ac3c28b550b17e9fdcb8c380ffbbd76b -
Branch / Tag:
refs/heads/main - Owner: https://github.com/Xoudusz
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
deploy.yml@91836056ac3c28b550b17e9fdcb8c380ffbbd76b -
Trigger Event:
push
-
Statement type:
