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

Google Search Console MCP server for SEOs

AminForou

Google Search Console Insights with Claude AI for SEOs

1.1K

MCP SearXNG Enhanced Server

OvertliDS

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

54

Google Search Tool

web-agent-master

A Playwright-based Node.js tool that bypasses search engine anti-scraping mechanisms to execute Google searches. Local alternative to SERP APIs with MCP server integration.

611

Perplexity MCP Zerver

wysh3

MCP web search using perplexity without any API KEYS

93

Naver Search MCP Server

isnow890

MCP server for Naver Search API integration. Provides comprehensive search capabilities across Naver services (web, news, blog, shopping, etc) and data trend analysis tools via DataLab API.

77