file_reader_mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@file_reader_mcp list files in the projects folder on my Desktop"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 directoryFolders are shown with a trailing
/Results are sorted alphabetically
Access is restricted to paths under the allowed workspace
read_file— Reads the contents of a text fileReturns the full file content as a string
Supports files inside the allowed workspace only
search_files— Searches for files by keyword within a directory treeReturns 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.
Related MCP server: filesystem-mcp
Requirements
Python 3.10+
uv (recommended) or pip
Setup
uv syncRunning the server
uv run python src/server.pyThe 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.tomlAvailable Tools
3 toolslist_filesD
Inputs: directory. Returns: result
read_fileD
Inputs: file_path (required). Returns: result
search_filesD
Inputs: keyword (required), directory (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: listing files, reading file contents, and searching for files. No overlap or ambiguity.
All tools follow a verb_noun pattern, but read_file uses singular 'file' while list_files and search_files use plural 'files'. This minor inconsistency prevents a perfect score.
Three tools is well-scoped for a file reader server. Each tool serves a core need without redundancy or bloat.
For a read-only file server, the surface covers listing, reading, and searching—all essential operations. No obvious gaps for the stated purpose.
Maintenance
Related MCP Connectors
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
A simple MCP server built with FastMCP and python
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server to list and launch applications on MacOS19MIT
- AlicenseAqualityAmaintenanceFilesystem MCP server for AI assistants. Search, read, edit, and manage local files in directories you choose.6141,447 npm34MIT
- FlicenseNot gradedqualityDmaintenanceMCP server providing filesystem operations, shell execution, and web search capabilities.-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides secure access to local file system operations.MIT