Simple Files Vectorstore MCP Server

A Model Context Protocol (MCP) server that provides semantic search capabilities across files. This server watches specified directories and creates

Local serverstdio

What is the Simple Files Vectorstore MCP server?

Simple files vectorstore mcp server lets Claude, Cursor and other MCP clients work with Simple Files Vectorstore directly. 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.

What Simple Files Vectorstore does

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.

Key capabilities

  • 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

Installing the simple files vectorstore mcp server

Setup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.

Configuration

The server reads 5 environment variables: WATCH_DIRECTORIES, WATCH_CONFIG_FILE, CHUNK_SIZE, CHUNK_OVERLAP, IGNORE_FILE. Keep credentials in your client's env block or a secrets manager rather than committing them.

Where it fits

Developer-tool servers are usually the first ones people connect, because they turn "help me with this code" into an assistant that can actually read the repo and act on it. Simple Files Vectorstore sits in that group. Worth comparing against the other developer tools servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • Maintained by lishenxydlgzs.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the simple files vectorstore mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

How to install the Simple Files Vectorstore MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
WATCH_DIRECTORIESFilesystem location the server is allowed to use.Optional
WATCH_CONFIG_FILEConfiguration value read at startup.Optional
CHUNK_SIZEConfiguration value read at startup.Optional
CHUNK_OVERLAPConfiguration value read at startup.Optional
IGNORE_FILEConfiguration value read at startup.Optional

Frequently asked questions

It connects Simple Files Vectorstore to MCP-compatible AI assistants such as Claude and Cursor. Instead of copying data back and forth by hand, the assistant works with Simple Files Vectorstore directly.