@lishenxydlgzs/simple-files-vectorstore
A Model Context Protocol (MCP) server that provides semantic search capabilities across files. This server watches specified directories and creates vector embeddings of file contents, enabling semantic search across your documents.
Installation & Usage
Add to your MCP settings file:
MCP settings file locations:
- VSCode Cline Extension:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Claude Desktop App:
~/Library/Application Support/Claude/claude_desktop_config.json
Configuration
The server requires configuration through environment variables:
Required Environment Variables
You must specify directories to watch using ONE of the following methods:
WATCH_DIRECTORIES
: Comma-separated list of directories to watchWATCH_CONFIG_FILE
: Path to a JSON configuration file with awatchList
array
Example using WATCH_DIRECTORIES:
Example using WATCH_CONFIG_FILE:
The watch config file should have the following structure:
Optional Environment Variables
CHUNK_SIZE
: Size of text chunks for processing (default: 1000)CHUNK_OVERLAP
: Overlap between chunks (default: 200)IGNORE_FILE
: Path to a .gitignore style file to exclude files/directories based on patterns
Example with all optional parameters:
MCP Tools
This server provides the following MCP tools:
1. search
Perform semantic search across indexed files.
Parameters:
query
(required): The search query stringlimit
(optional): Maximum number of results to return (default: 5, max: 20)
Example response:
2. get_stats
Get statistics about indexed files.
Parameters: None
Example response:
Features
- Real-time file watching and indexing
- Semantic search using vector embeddings
- Support for multiple file types
- Configurable chunk size and overlap
- Background processing of files
- Automatic handling of file changes and deletions
Repository
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
A very simple vector store that provides capability to watch a list of directories, and automatically index all the markdown, html and text files in the directory to a vector store to enhance context.
Related Resources
Related MCP Servers
- -securityFlicense-qualityEnables efficient vector database operations for embedding storage and similarity search through a Model Context Protocol interface.Last updated -6Python
- AsecurityFlicenseAqualityA TypeScript-based server that visualizes project directory structures in Markdown format, automatically documenting file contents with syntax highlighting and supporting customizable exclusion patterns.Last updated -12482TypeScript
Vectorizeofficial
AsecurityAlicenseAqualityVectorize MCP server for advanced retrieval, Private Deep Research, Anything-to-Markdown file extraction and text chunking.Last updated -32981JavaScriptMIT License- -securityFlicense-qualityManages markdown notes in a specified directory, allowing users to create, read, update, and list notes through the Model Context Protocol.Last updated -1Python