Overview
MCP File Navigator is a secure Model Context Protocol server designed for safe file system operations. It provides AI assistants with controlled access to files and directories while maintaining strict security through path validation and dynamic storage management.
Features
File Operations
- Read file contents with encoding support
- Write new files safely
- Append to existing files
- Update file contents
- Delete files with confirmation
- Copy and move files
Directory Management
- List directory contents
- Create directory hierarchies
- Remove directories
- Navigate directory structures
- Search within directories
Path Security
- Robust Validation: Prevent directory traversal
- Whitelist Approach: Configurable allowed paths
- Path Normalization: Handle various path formats
- Symbolic Link Protection: Prevent link exploits
Dynamic Storage Management
- Configure storage locations at runtime
- Multiple storage root support
- Workspace-based organization
- Temporary file handling
- Storage quota management
Security Architecture
- Path sanitization
- File name validation
- Extension checking
- Size limits
- Content validation
Access Control
- Per-directory permissions
- Operation-level restrictions
- Read-only mode
- Write protection
Audit & Compliance
- Operation logging
- Access tracking
- Change history
- Security events
Use Cases
- Secure document management
- Configuration file editing
- Log file analysis
- Content generation and storage
- File-based workflows
- Data import/export
- Template processing
- Backup operations
Configuration
Storage Locations
{
"storageRoots": [
"/allowed/path/1",
"/allowed/path/2"
],
"defaultRoot": "/allowed/path/1"
}
Security Settings
{
"maxFileSize": "10MB",
"allowedExtensions": ["txt", "md", "json"],
"readOnly": false
}
Technical Implementation
Built with security-first approach using modern file system APIs and comprehensive validation layers. Implements fail-safe mechanisms to prevent unauthorized access.
Integration
Compatible with Claude Desktop, Cursor, VS Code, and other MCP clients. Requires configuration of allowed storage locations before use.
- Efficient file streaming
- Cached directory listings
- Async operations
- Minimal memory footprint
