ML File Manager Pro

Version: 1.6.18
Author: 1WD LLC
Website: WPLaunchify.com
License: GPL v2 or later

🚀 Production-Ready WordPress MCP File Manager

ML File Manager Pro is a comprehensive WordPress plugin that provides complete filesystem access through the Model Context Protocol (MCP). It serves as a complete SFTP replacement, enabling AI agents like Claude (Cursor) to perform full file management operations on your WordPress server.

✅ PRODUCTION READY - VERSION 1.6.18

• 100% Functionality: All 12 MCP tools working perfectly
• Enterprise Security: Robust path validation and API key management
• Universal Compatibility: Works with Cursor, Claude Desktop, and any MCP client
• Comprehensive Documentation: Ready for deployment and integration

✨ Key Features

🔧 Complete File System Operations

• File Management: Read, write, delete, copy, move files
• Directory Operations: Create, list, navigate directories
• Archive Support: Create and extract ZIP files
• Permission Control: Change file permissions (chmod)
• Pattern Matching: Find files using glob patterns
• Path Security: Robust security with allowed root validation

🤖 AI Agent Integration

• MCP Protocol: Full JSON-RPC 2.0 compliance
• Cursor IDE: Perfect integration with Cursor's MCP system
• Claude Support: Works with Claude and other MCP-compatible AI tools
• Tool Discovery: Automatic tool registration and schema validation

🔐 Enterprise Security

• API Key Management: Generate, revoke, and manage API keys
• Path Validation: Prevents directory traversal attacks
• Allowed Roots: Configurable filesystem access boundaries
• WordPress Integration: Native WordPress authentication support

📦 Installation

1. Upload the ml-file-manager.php file to your /wp-content/plugins/ directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Navigate to ML File Manager in your WordPress admin menu
4. Generate an API key in the API Settings section

🔧 Configuration

For Cursor IDE (Recommended)

1. Open Cursor → Settings → MCP Servers → Edit JSON
2. Add the following configuration:

{
  "mcpServers": {
    "ml-file-manager": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "mcp-remote@0.1.29",
        "-p", 
        "undici@7",
        "mcp-remote",
        "https://yoursite.com/wp-json/ml-file-manager/v1/mcp-http?X-API-Key=YOUR_API_KEY",
        "--transport",
        "http-only"
      ]
    }
  }
}

3. Replace https://yoursite.com with your WordPress site URL
4. Replace YOUR_API_KEY with the API key generated in WordPress admin
5. Save and click Reconnect (or restart Cursor)

🛠️ Available MCP Tools

All 12 tools are 100% functional and production-ready:

Core Operations

• mcp_ml-file-manager_get_status - Get system status and plugin info
• mcp_ml-file-manager_list_files - List files and directories
• mcp_ml-file-manager_fs_stat - Get file/directory information

File Content Operations

• mcp_ml-file-manager_fs_read - Read file contents (text or base64)
• mcp_ml-file-manager_fs_write - Write content to files
• mcp_ml-file-manager_fs_delete - Delete files or directories

Advanced Operations

• mcp_ml-file-manager_fs_copy - Copy files or directories
• mcp_ml-file-manager_fs_move - Move/rename files or directories
• mcp_ml-file-manager_fs_chmod - Change file permissions
• mcp_ml-file-manager_fs_zip - Create ZIP archives
• mcp_ml-file-manager_fs_unzip - Extract ZIP archives
• mcp_ml-file-manager_fs_glob - Find files matching patterns
• mcp_ml-file-manager_fs_mkdir - Create directories

💡 Usage Examples

Basic File Operations

// List files in current directory
mcp_ml-file-manager_list_files({folder: "."})

// Read a configuration file
mcp_ml-file-manager_fs_read({path: "wp-config.php"})

// Write content to a file
mcp_ml-file-manager_fs_write({
  path: "custom-config.txt", 
  content: "Custom configuration data"
})

Advanced Operations

// Create a backup ZIP
mcp_ml-file-manager_fs_zip({
  source_paths: ["wp-content/themes/my-theme"],
  zip_path: "backups/theme-backup.zip"
})

// Find all PHP files
mcp_ml-file-manager_fs_glob({pattern: "**/*.php"})

// Copy a directory
mcp_ml-file-manager_fs_copy({
  source: "wp-content/themes/original",
  target: "wp-content/themes/backup"
})

🔒 Security Features

Path Security

• Allowed Roots: Access restricted to configured safe directories
• Path Validation: Prevents directory traversal attacks
• Realpath Resolution: Resolves symbolic links safely

Authentication

• API Key System: Secure token-based authentication
• WordPress Integration: Fallback to WordPress user permissions
• Key Management: Generate, revoke, and delete API keys

🚀 Production Deployment

System Requirements

• WordPress: 5.0 or higher
• PHP: 7.4 or higher
• Extensions: ZipArchive (for archive operations)
• Permissions: Write access to WordPress directories

Performance Considerations

• File Size Limits: 2MB read limit for individual files
• Glob Results: 5000 file limit for pattern matching
• Memory Usage: Optimized for large directory operations

🔄 Integration with Other Plugins

ML File Manager Pro is designed to work seamlessly alongside other 1WD LLC plugins:

• Consistent Branding: Matches 1WD LLC plugin standards
• Shared Dependencies: Compatible with other MCP-enabled plugins
• API Compatibility: Follows WordPress REST API best practices
• Resource Sharing: Efficient resource usage in multi-plugin environments

🔄 Version History

v1.6.18 (Current - Production Ready) ✅

• 100% Functionality: All 12 MCP tools working perfectly
• Production Ready: Comprehensive testing and validation
• Security Hardened: Robust path validation and security controls
• Performance Optimized: Efficient file operations and memory usage

🤝 Support

For support and documentation:

• Website: WPLaunchify.com
• Documentation: Available in WordPress admin panel
• GitHub: Issues and feature requests

📄 License

This plugin is licensed under the GPL v2 or later.

---

Developed by 1WD LLC | WPLaunchify.com

Empowering WordPress with AI-driven file management capabilities.