file_reader_mcp
An MCP server for reading files from the local filesystem. Currently supports listing files in directories on the Desktop.
README
file_reader_mcp
An MCP (Model Context Protocol) server for reading and discovering files from the local filesystem.
Current capabilities
This project now provides three MCP tools:
-
list_files— Lists files and folders in a given directory- Folders are shown with a trailing
/ - Results are sorted alphabetically
- Access is restricted to paths under the allowed workspace
- Folders are shown with a trailing
-
read_file— Reads the contents of a text file- Returns the full file content as a string
- Supports files inside the allowed workspace only
-
search_files— Searches for files by keyword within a directory tree- Returns matching file paths
- Helps quickly locate relevant files
Implementation notes
- The file access layer has been updated to use
pathlibinstead ofosfor a more modern and readable path handling approach. - Access is still restricted to a safe allowed root for security.
Requirements
- Python 3.10+
- uv (recommended) or pip
Setup
uv sync
Running the server
uv run python src/server.py
The server uses stdio transport and is meant to be configured as an MCP server in Cursor or another MCP-compatible client.
Project structure
file_reader_mcp/
├── src/
│ ├── file_access.py # Pathlib-based file access helpers
│ └── server.py # MCP server exposing list_files, read_file, and search_files
├── test/
│ └── test_os.py # Local tests for directory listing
└── pyproject.toml
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.
E2B
Using MCP to run code via e2b.