FS-MCP: Universal File Reader & Intelligent Search MCP Server

What is FS-MCP: Universal File Reader & Intelligent Search MCP Server?

FS-MCP: Universal File Reader & Intelligent Search MCP Server is a powerful MCP (Model Context Protocol) server that provides intelligent file reading and semantic search capabilities. It automatically detects text files, supports multiple document formats, and offers AI-powered vector search for developers using MCP-compatible clients.

How to use FS-MCP: Universal File Reader & Intelligent Search MCP Server?

Clone the repository, install dependencies with uv sync or pip install -r requirements.txt, and configure environment variables (e.g., SAFE_DIRECTORY, MAX_FILE_SIZE_MB, and embedding API keys) in a .env file. Start the server with python main.py, then connect via SSE at http://localhost:3002 or add the server to your MCP client configuration (e.g., Claude Desktop).

Key features of FS-MCP: Universal File Reader & Intelligent Search MCP Server?

• Intelligent text detection without relying on file extensions
• Multi-format support (text, Word, Excel, PDF, etc.) with automatic Markdown conversion
• Security-first access restricted to configured safe directories
• Line range reading for large files and quick file previews
• Semantic vector search using AI embeddings (BAAI/bge-m3 model)
• Multi-language support for English and Chinese content

Use cases of FS-MCP: Universal File Reader & Intelligent Search MCP Server?

• Search code semantically for “authentication logic” and find related “login verification” code
• Read specific line ranges from large log or source files efficiently
• Preview file contents and list files with pattern matching for quick exploration
• Rebuild vector indexes and retrieve index statistics for monitoring

FAQ from FS-MCP: Universal File Reader & Intelligent Search MCP Server

What file formats does the server support?

It supports auto-detected text files (.py, .js, .json, .md, etc.) and document formats (.docx, .xlsx, .pptx, .pdf, .odt, .ods, .odp) that are automatically converted to Markdown.

How do I restrict which directories the server can access?

Set the SAFE_DIRECTORY environment variable to the root directory you want to allow; the server will limit all file