Platform-Agnostic Filesystem MCP Server

Overview

Platform-Agnostic Filesystem MCP Server provides comprehensive file system operations that work seamlessly across all major operating systems. It offers advanced features including sophisticated search/replace and directory tree traversal.

Features

Advanced Search/Replace

• Multi-file search and replace
• Regex pattern support
• Preview before applying changes
• Batch operations
• Rollback capabilities
• Case-sensitive/insensitive options

Directory Tree Operations

• Recursive directory listing
• Tree structure visualization
• Filtered traversal
• Size calculation
• File count statistics

File Management

• Create, read, update, delete files
• File copying and moving
• Symbolic link handling
• File permissions management
• Metadata manipulation

Cross-Platform Compatibility

• Windows: Full NTFS support, drive letters, UNC paths
• macOS: HFS+/APFS support, extended attributes
• Linux: ext4/btrfs support, permissions, ownership

Advanced Capabilities

Path Handling

• Normalize paths across platforms
• Handle path separators (/ vs )
• Resolve relative paths
• Expand environment variables
• Handle special characters

File Watching

• Monitor file changes
• Directory event notifications
• Debounced events
• Recursive watching

Atomic Operations

• Ensure data consistency
• Transaction-like behavior
• Rollback on failure
• Temporary file handling

Use Cases

• Cross-platform file management automation
• Code refactoring across multiple files
• Log file processing
• Configuration file updates
• Bulk file operations
• Directory synchronization
• Content migration
• File system auditing

Security Features

• Path validation and sanitization
• Configurable access restrictions
• Operation whitelisting
• Audit trail
• No privilege escalation

Technical Implementation

Built with Node.js using platform-agnostic APIs and fallbacks for platform-specific features. Implements robust error handling for cross-platform edge cases.

Integration

Compatible with Claude Desktop, Cursor, VS Code, and other MCP clients on any supported platform.

Performance

• Streaming for large files
• Efficient directory traversal
• Parallel operations
• Memory-efficient processing
• Lazy loading