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

@boleyn

Repository

Basic information

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

文件资料查找mcp服务

#fs-mcp#file-reader#intelligent-search

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

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "fs-mcp-server": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

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

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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

Frequently asked questions

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

Comments

More Search MCP servers

3GPP Scout

3gppscout

Hosted 3GPP MCP server: cited search across Rel-15 through Rel-20 TS/TR specs, recent TDocs, company proposals and meeting decisions. OAuth 2.1; no local index required.

Free SEO Audit for Claude

houtini.com

Free SEO Audit MCP server for Claude - captures and stores all the raw data you need for a complete technical SEO audit. Google Search Console + a first-party crawl + DataForSEO + Majestic SEO merged into one prioritised

Theyond

theyond

If it's here, it's on their board. Search live verified jobs from employer career pages.

InstaVision

Find Instagram creators and leads by niche, city, follower range or lookalike accounts.

Fitralo

Search Europe's road freight carriers from your AI assistant: find carriers by route, equipment and certificates among 15,700+ checked carriers in 32 countries, in 14 languages. Read-only, no account needed for searching