MCP File Manager
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., "@MCP File Manager list files in the current directory"
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.
MCP File Manager
A local file management MCP server built with Python and the official mcp library (FastMCP).
Features
List Files: List contents of directories.
Read Files: Read content of text files.
File Info: Get metadata (size, modification time) of files.
Search: Recursively search for files by name.
Related MCP server: MCP Filesystem Server
Dependencies
Python 3.10+
uv(recommended) orpip
Quick Start
Install dependencies:
uv syncRun the server:
uv run main.py
Claude Desktop Configuration
Add the following to your Claude Desktop config file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"file-manager": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/MCP-file-managment",
"run",
"main.py"
]
}
}
}Note: Replace /ABSOLUTE/PATH/TO/MCP-file-managment with the actual absolute path to the directory where you cloned this repository.
Available Tools
list_files(directory): List files and directories in the specified path (defaults to current directory).read_file(file_path): Read the content of a text file.file_info(file_path): Get file size, type, and modification time.search_files(keyword): Recursively search for filenames containing a keyword in the current working directory.
Available Tools
4 toolsfile_infoA
Get metadata about a file.
Args:
file_path: Relative path to the file.
Inputs: file_path (required). Returns: result
list_filesA
List files and directories in the specified path within the workspace.
Args:
directory: Relative path to the directory (default is root of workspace).
Inputs: directory. Returns: result
read_fileB
Read the contents of a text file.
Args:
file_path: Relative path to the file.
Inputs: file_path (required). Returns: result
search_filesA
Recursively search for files whose names contain the keyword.
Searches from the current working directory.
Args:
keyword: String to search for in filenames.
Inputs: keyword (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 4 tools
Each tool targets a distinct file operation: listing directory contents, reading file content, fetching metadata, and searching filenames. There is no overlap, so an agent can easily choose the right tool.
Three tools use the verb_noun pattern (list_files, read_file, search_files), but file_info is a noun phrase rather than a verb action. The naming is mostly consistent but has a minor deviation.
Four tools is a well-scoped number for a focused file management server. Each tool serves a clear purpose without unnecessary bloat.
The server only provides read-only operations (list, read, info, search). There are no tools for creating, editing, or deleting files, which are essential for a true file manager, leaving significant gaps.
Maintenance
Related MCP Connectors
Browse and manage files in your Moxt AI workspace from any MCP client.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Manage files and folders directly from your workspace. Read and write files, list directories, cre…
Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables file system operations such as listing, reading, and creating files within a scoped local project directory. It provides a secure way to manage local files through standardized MCP tools built with FastMCP.-
- AlicenseNot gradedqualityDmaintenanceEnables file system operations such as listing directories, reading, writing, creating, and deleting files or directories through MCP.21 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables safe, read-only browsing of allowlisted local directories through MCP, providing tools to list roots, read files, and search text.MIT
- FlicenseAqualityCmaintenanceEnables saving and managing files in a sandboxed local folder via MCP, with tools for listing, reading, writing, appending, searching, moving, and deleting files and directories.10-