Simple Files Vector Store Server

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

1. search

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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

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

Reddit Discussion about this server

Related MCP Servers

SourceSage MCP
Sunwood-ai-labs
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
516
2
Notes MCP Server
nathannj
-
security
F
license
-
quality
Manages markdown notes in a specified directory, allowing users to create, read, update, and list notes through the Model Context Protocol.
Last updated -
1
Markdown MCP Server
huntkil
-
security
F
license
-
quality
A server that provides HTTP API access to manage Obsidian Vaults and Markdown files, allowing users to access notes, statistics, links, templates, and search capabilities.
Last updated -
MCP VectorStore Server
BierschneiderEmanuel
-
security
A
license
-
quality
Provides advanced document search and processing capabilities through vector stores, including PDF processing, semantic search, web search integration, and file operations. Enables users to create searchable document collections and retrieve relevant information using natural language queries.
Last updated -
MIT License

View all related MCP servers

Simple Files Vector Store Server

@lishenxydlgzs/simple-files-vectorstore

Installation & Usage

Configuration

Required Environment Variables

Optional Environment Variables

MCP Tools

1. search

2. get_stats

Features

Repository

Related Resources

Related MCP Servers

SourceSage MCP

Notes MCP Server

Markdown MCP Server

MCP VectorStore Server

Appeared in Searches

New MCP Servers

MCP directory API