Simple Files Vector Store Server

Integrations

  • Supports .gitignore-style file exclusion patterns through the IGNORE_FILE configuration to control which files are indexed.

  • Supports indexing and searching Markdown files, allowing semantic queries across Markdown document content.

@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:

{ "mcpServers": { "files-vectorstore": { "command": "npx", "args": [ "-y", "@lishenxydlgzs/simple-files-vectorstore" ], "env": { "WATCH_DIRECTORIES": "/path/to/your/directories" }, "disabled": false, "autoApprove": [] } } }

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 watch
  • WATCH_CONFIG_FILE: Path to a JSON configuration file with a watchList array

Example using WATCH_DIRECTORIES:

{ "mcpServers": { "files-vectorstore": { "command": "npx", "args": [ "-y", "@lishenxydlgzs/simple-files-vectorstore" ], "env": { "WATCH_DIRECTORIES": "/path/to/dir1,/path/to/dir2" }, "disabled": false, "autoApprove": [] } } }

Example using WATCH_CONFIG_FILE:

{ "mcpServers": { "files-vectorstore": { "command": "npx", "args": [ "-y", "@lishenxydlgzs/simple-files-vectorstore" ], "env": { "WATCH_CONFIG_FILE": "/path/to/watch-config.json" }, "disabled": false, "autoApprove": [] } } }

The watch config file should have the following structure:

{ "watchList": [ "/path/to/dir1", "/path/to/dir2", "/path/to/specific/file.txt" ] }

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:

{ "mcpServers": { "files-vectorstore": { "command": "npx", "args": [ "-y", "@lishenxydlgzs/simple-files-vectorstore" ], "env": { "WATCH_DIRECTORIES": "/path/to/dir1,/path/to/dir2", "CHUNK_SIZE": "2000", "CHUNK_OVERLAP": "500", "IGNORE_FILE": "/path/to/.gitignore" }, "disabled": false, "autoApprove": [] } } }

MCP Tools

This server provides the following MCP tools:

Perform semantic search across indexed files.

Parameters:

  • query (required): The search query string
  • limit (optional): Maximum number of results to return (default: 5, max: 20)

Example response:

[ { "content": "matched text content", "source": "/path/to/file", "fileType": "markdown", "score": 0.85 } ]

2. get_stats

Get statistics about indexed files.

Parameters: None

Example response:

{ "totalDocuments": 42, "watchedDirectories": ["/path/to/docs"], "processingFiles": [] }

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

GitHub Repository

-
security - not tested
A
license - permissive license
-
quality - not tested

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.

  1. Installation & Usage
    1. Configuration
      1. Required Environment Variables
      2. Optional Environment Variables
    2. MCP Tools
      1. 1. search
      2. 2. get_stats
    3. Features
      1. Repository

        Related MCP Servers

        • -
          security
          F
          license
          -
          quality
          This server provides an interface for performing basic file system operations such as navigation, reading, writing, and file analysis, allowing users to manage directories and files efficiently.
          Last updated -
          3
          Python
        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol server providing vector database capabilities through Chroma, enabling semantic document search, metadata filtering, and document management with persistent storage.
          Last updated -
          17
          Python
          MIT License
          • Apple
          • Linux
        • A
          security
          F
          license
          A
          quality
          A 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 -
          1
          3
          2
          TypeScript
          • Linux
          • Apple
        • A
          security
          A
          license
          A
          quality
          A server that allows users to manage documents and perform Claude-powered searches using Needle through the Claude Desktop application.
          Last updated -
          7
          39
          Python
          MIT License
          • Apple

        View all related MCP servers

        ID: 8az6gm4zz3