spindl-dev-kb

FAISS-backed knowledge base MCP server for software development context.

Installation

pip install -e .

Usage

Add to your Claude Code MCP configuration:

{
  "mcpServers": {
    "spindl-dev-kb": {
      "command": "spindl-dev-kb",
      "args": []
    }
  }
}

Environment Variables

Variable	Default	Description
SPINDL_KB_STORE_DIR	./vector_stores	Where FAISS indices are stored
SPINDL_KB_OLLAMA_URL	http://localhost:11434	Ollama API endpoint
SPINDL_KB_EMBEDDING_MODEL	snowflake-arctic-embed2	Ollama embedding model
SPINDL_KB_EMBEDDING_DIM	1024	Embedding vector dimension
SPINDL_KB_CHUNK_SIZE	512	Text chunk size in characters
SPINDL_KB_CHUNK_OVERLAP	64	Overlap between chunks

MCP Tools

• search_knowledge — Vector similarity search across indexed scopes
• list_scopes — Show all indexed scopes and chunk counts
• ingest — Add a file or directory to a scope
• reindex — Delete and rebuild a scope from source

License

MIT