MCP.so
Sign In

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

@boleyn

Repository

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

文件资料查找mcp服务

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

Basic information

Category

Search

License

MIT

Runtime

python

Transports

stdio

Publisher

boleyn

Config

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

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

Tools

No tools detected

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

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

Comments

More Search MCP servers

Brave Search MCP Server

mikechao

An MCP Server implementation that integrates the Brave Search API, providing, Web Search, Local Points of Interest Search, Image Search, Video Search, News Search and LLM Context Search capabilities

121

MCP SearXNG Enhanced Server

OvertliDS

Enhanced MCP server for SearXNG: category-aware web-search, web-scraping, and date/time retrieval.

54

SerpApi MCP Server

ilyazub

SerpApi MCP Server for Google and other search engine results

154

G-Search MCP

jae-jae

A powerful MCP server for Google search that enables parallel searching with multiple keywords simultaneously.

268

DuckDuckGo Search MCP Server

nickclyde

A Model Context Protocol (MCP) server that provides web search capabilities through DuckDuckGo, with additional features for content fetching and parsing.

1.3K