FS-MCP: Universal File Reader & Intelligent Search MCP Server
About
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…
Details
- Author
- boleyn
- GitHub stars
- 7
- Downloads
- 387
- Categories
- Search, Other
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
FS-MCP: Universal File Reader & Intelligent Search MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"fs-mcp: universal file reader & intelligent search mcp server": {
"fs-mcp-server": {
"command": "uv",
"args": [
"sync"
]
}
}
}
}McpServers
{
"fs-mcp-server": {
"command": "uv",
"args": [
"sync"
]
}
}FS-MCP: Universal File Reader & Intelligent Search MCP Server
<div align="center">
A powerful MCP (Model Context Protocol) server that provides intelligent file reading and semantic search capabilities
</div>
---
English
🚀 Features
- 🧠 Intelligent Text Detection: Automatically identifies text files without relying on file extensions
- 📄 Multi-Format Support: Handles text files and document formats (Word, Excel, PDF, etc.)
- 🔒 Security First: Restricted access to configured safe directories only
- 📏 Range Reading: Supports reading specific line ranges for large files
- 🔄 Document Conversion: Automatic conversion of documents to Markdown with caching
- 🔍 Vector Search: Semantic search powered by AI embeddings
- ⚡ High Performance: Batch processing and intelligent caching support
- 🌐 Multi-language: Supports both English and Chinese content
📋 Table of Contents
- Quick Start
- Installation
- Configuration
- MCP Tools
- Vector Search
- Supported Formats
- Security Features
- Integration
- Development
- Contributing
- License
🚀 Quick Start
1. Clone and Install
git clone https://github.com/yourusername/fs-mcp.git
cd fs-mcp
Using uv (Recommended):
uv sync
Using pip:
```bash
pip install -r requirements.txt # If you have a requirements.txt
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
