File System MCP Server
About
A comprehensive MCP (Model Context Protocol) server for file system operations, providing Claude and other AI assistants with access to local files and directories.
Details
- Author
- calebmwelsh
- Downloads
- 256
- Categories
- File Management, Other, Developer Tools
Jump to
- Copy, move, delete files with backup and safety checks
- Read, write, and search files by name pattern
- List, create, delete directories, including recursive tree views
- Get file information, directory statistics, disk usage, and system info
- Create file collections with optional custom storage path
- Windows full support; macOS/Linux support for basic operations
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
File System 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, create and activate a virtual environment, install dependencies with pip install -r requirements.txt, then configure the server in your MCP client (e.g., Claude) by adding the server's command and path to claude_desktop_config.json. After configuration, restart the client and use the provided tools by asking the AI to perform file operations.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"file system mcp server": {
"file-system-mcp-server": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}
}
}McpServers
{
"file-system-mcp-server": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}File System MCP Server
A powerful file system management server built with FastMCP that provides a comprehensive set of tools for file and directory operations. This server allows you to perform various file system operations through a structured API, making it ideal for automation and integration with other systems.
Platform Support
The server is designed to work across different operating systems, but with varying levels of functionality:
Windows
- Full feature support - Drive listing - Special folders access - Windows-specific path handling - Detailed system informationmacOS/Linux
- Basic file operations - Directory operations - File search and metadata - Basic system information - Note: Some Windows-specific features are not availableFuture Implementation
Planned macOS Support
- Native path handling for macOS - macOS-specific system information retrieval - Integration with macOS file system features - Support for macOS-specific file attributes - Implementation of macOS-specific utilities (similar to windows_utils.py)Planned Linux Support
- Native path handling for Linux - Linux-specific system information retrieval - Integration with Linux file system features - Support for Linux file permissions and attributes - Implementation of Linux-specific utilitiesCross-Platform Improvements
- Unified path handling system - Platform-agnostic drive detection - Consistent system information API - Standardized file attributes across platforms - Cross-platform file system event monitoring - Universal file collection systemTimeline
- Phase 1: Basic cross-platform compatibility improvements - Phase 2: Platform-specific feature implementations - Phase 3: Advanced cross-platform features - Phase 4: Performance optimizations and refinementsFeatures
File Operations
- Copy files with backup support - Move files with backup support - Delete files with safety checks - Read file contents - Write file contents - Get file information (size, creation time, modification time) - Search files by name pattern - Create file collections for organizing related filesDirectory Operations
- List directory contents - Create directories - Delete directories - List directories recursively (tree-like structure) - Search directories by name patternSystem Information
- Get system information (OS, CPU, memory, disk usage) - Get disk information (total space, used space, free space) - Get directory information (file count, total size)Project Structure
file-system-mcp-server/
├── fs_server.py # Main server implementation
├── windows_utils.py # Windows-specific utilities (Windows only)
├── requirements.txt # Project dependencies
└── test_prompts_example.md # Example test prompts
Collections Storage
Collections can be stored in any directory specified by the user. If no storage location is specified, collections will be stored in a default location within the project's data/collections directory.
Example usage:
```python
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
