Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_MODE | No | Communication mode for the MCP server. | stdio |
| PROJECT_ROOTS | No | Environment variable for project roots. High priority configuration. | |
| LOCALNEST_CONFIG | No | Path to the LocalNest configuration file. | ~/.localnest/config/localnest.config.json |
| LOCALNEST_DB_PATH | No | SQLite database path. | ~/.localnest/data/localnest.db |
| LOCALNEST_EMBED_DIMS | No | Embedding vector dimensions. | 384 |
| LOCALNEST_INDEX_PATH | No | JSON index path. | ~/.localnest/data/localnest.index.json |
| LOCALNEST_EMBED_MODEL | No | Embedding model name. | Xenova/all-MiniLM-L6-v2 |
| LOCALNEST_INDEX_BACKEND | No | Index backend to use: 'sqlite-vec' or 'json'. | sqlite-vec |
| LOCALNEST_EMBED_PROVIDER | No | Embedding backend provider. | xenova |
| LOCALNEST_MEMORY_BACKEND | No | Memory backend: 'auto', 'node-sqlite', or 'sqlite3'. | auto |
| LOCALNEST_MEMORY_DB_PATH | No | SQLite memory database path. | ~/.localnest/data/localnest.memory.db |
| LOCALNEST_MEMORY_ENABLED | No | Enable local memory subsystem. | false |
| LOCALNEST_RERANKER_MODEL | No | Cross-encoder reranker model name. | Xenova/ms-marco-MiniLM-L-6-v2 |
| LOCALNEST_UPDATE_PACKAGE | No | npm package name to check/update. | localnest-mcp |
| LOCALNEST_EMBED_CACHE_DIR | No | Embedding model cache path. | ~/.localnest/cache |
| LOCALNEST_VECTOR_MAX_FILES | No | Max files per index run. | 20000 |
| LOCALNEST_VECTOR_MAX_TERMS | No | Max terms per chunk. | 80 |
| LOCALNEST_RERANKER_PROVIDER | No | Reranker backend provider. | xenova |
| LOCALNEST_RERANKER_CACHE_DIR | No | Reranker model cache path. | ~/.localnest/cache |
| LOCALNEST_VECTOR_CHUNK_LINES | No | Lines per index chunk. | 60 |
| LOCALNEST_MEMORY_AUTO_CAPTURE | No | Allow background event ingest to promote memories automatically. | false |
| LOCALNEST_MEMORY_CONSENT_DONE | No | Indicates setup memory consent was already collected. | false |
| LOCALNEST_SQLITE_VEC_EXTENSION | No | Optional custom native extension path for sqlite-vec. If unset, no native extension load is attempted. | |
| LOCALNEST_VECTOR_CHUNK_OVERLAP | No | Overlap between chunks. | 15 |
| LOCALNEST_UPDATE_CHECK_INTERVAL_MINUTES | No | Refresh interval for npm update checks. | 120 |
| LOCALNEST_UPDATE_FAILURE_BACKOFF_MINUTES | No | Retry interval when npm check fails. | 15 |
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |