🗂️ File System MCP v1.1.0 - Interactive Homepage & Enhanced User Experience

🚀 File System MCP Server v1.1.0

This release introduces a comprehensive homepage redesign with interactive tool exploration capabilities, significantly enhancing the user experience for the File System MCP Server.

🚀 What's New

✨ Interactive Homepage with Tool Browser

• 🏠 New Homepage: Complete tool browser at http://localhost:20252/ showcasing all 20 file system MCP tools
• 🔍 Advanced Search: Real-time search functionality across tool names and descriptions
• 📂 Category Filtering: Organized tools by categories (Directories, Files, System) with intuitive filter buttons
• 📊 Tool Documentation: Click-to-view detailed modals with parameter information and usage examples
• 📱 Responsive Design: Modern glassmorphism UI optimized for desktop and mobile devices

⚙️ Enhanced User Experience

• 🔗 Permissions Management: Direct access to file permissions management at /manage-permissions
• 🎨 Professional UI: Smooth animations, hover effects, and professional color schemes
• ⌨️ Keyboard Support: Full keyboard navigation with Escape key modal closing
• 🔄 Interactive Elements: Clickable tool cards with detailed information on demand

🏗️ Technical Improvements

• 📦 Enhanced Tool Architecture: All tools now use structured metadata from mcp-utils integration
• 🎯 Type Safety: Comprehensive TypeScript interfaces for all data structures
• ⚡ Build Process: Unified build script execution across all platforms
• 🔧 Better Error Handling: Improved error reporting across all tool implementations

📋 Key Features

• 20 File System Tools organized in an interactive browser
• Real-time Search with instant filtering capabilities
• Category-based Organization for better tool discovery
• Detailed Documentation with examples and parameter guides
• Professional Web Interface with modern design principles
• Cross-platform Compatibility for macOS, Windows, and Linux

🛠️ Technical Details

Dependencies Updated:

• @modelcontextprotocol/sdk: ^1.17.4 → ^1.18.0
• mcp-utils: Integrated for enhanced tool management

New Files:

• src/templates/homepageHTML.ts - Interactive homepage with 600+ lines of HTML, CSS, and JavaScript
• src/types/index.ts - Centralized TypeScript type definitions

Architecture Changes:

• Enhanced tool registration with dynamic parameter descriptions
• Unified error handling across all tools

🎯 Installation & Usage

Quick Start:

1. Download the pre-built executable for your platform
2. Run the executable to start the server
3. Visit http://localhost:20252/ to explore available tools
4. Integrate with Claude Desktop for AI-powered file operations

From Source:

git clone https://github.com/chayan-1906/FS-MCP.git
cd FS-MCP
npm install
npm run dev

📈 Impact

This release transforms the FS-MCP from a headless server into a user-friendly platform with:

• Enhanced Discoverability: Users can now browse and understand all available tools before integration
• Better Documentation: Each tool includes detailed descriptions, parameters, and usage examples
• Improved Developer Experience: Professional UI makes it easier to understand server capabilities
• Modern Web Standards: Responsive design works across all devices and screen sizes

---

🔗 Homepage: http://localhost:20252/
⚙️ Permissions: http://localhost:20252/manage-permissions
📚 Documentation: FS-MCP User Guide

Perfect for developers who need comprehensive file system operations with Claude and other AI agents!

🗂️ File System MCP v1.0.0 - Initial Release

🚀 File System MCP Server v1.0.0

First stable release of the MCP-compliant File System integration server.

✨ Features

• 17 File System Tools for AI agents (Claude, etc.)
• Web-Based Permissions Manager with real-time configuration
• Complete File Operations - Read, write, create, delete, copy, move, rename files
• Directory Management - Create, delete, list, navigate directory structures
• Office Document Support - Create and read Excel, PowerPoint, Word documents
• Advanced Tree Visualization - Hierarchical directory tree with filtering
• Security-First Design - Granular permissions system with read/write access control
• Shell Command Execution - Execute system commands with security measures

📦 Available Downloads

• Pre-built executables for macOS, Windows
• Source code for manual installation

🔧 Tech Stack

• TypeScript
• MCP SDK
• Express.js
• File System APIs
• ExcelJS, Docx, PptxGenJS
• Zod validation
• CORS

🛠️ Available Tools

Directory Operations (5 tools)

• get-directory-content - Lists files and folders within directories
• create-directory - Creates new directories
• delete-directory - Deletes directories
• list-allowed-directories - Returns configured permissions
• directory-tree - Generates hierarchical tree views with filtering

File Operations (8 tools)

• read-file - Reads file content with line numbers and range support
• create-file - Creates new empty files
• modify-file - Insert, replace, or delete specific lines
• copy-file - Copies files to new locations
• delete-file - Deletes files
• get-file-directory-info - Retrieves metadata about files/directories
• search-file-directory - Searches for files and directories by name
• move-rename-file-directory - Moves or renames files and directories

Office Document Tools (6 tools)

• create-excel - Creates Excel sheets with advanced styling
• read-excel - Reads Excel files and extracts data
• create-presentation - Creates PowerPoint presentations
• read-presentation - Reads PowerPoint files and extracts content
• create-document - Creates Word documents with formatting
• read-document - Reads Word documents and extracts text

System Tools (1 tool)

• run-shell-command - Executes shell commands on the server

🔒 Security Features

• Path validation preventing directory traversal attacks
• Permission boundaries restricting access to allowed paths
• Operation validation for read/write permissions
• Safe path resolution and validation
• Error isolation preventing information leakage
• Configuration protection for permissions file

📖 Documentation

Complete setup guide and tool documentation available in README.

🎯 What's Next

• Additional Office format support (PDF, CSV)
• Enhanced file search capabilities
• Performance optimizations
• Extended metadata extraction

Full Changelog: https://github.com/chayan-1906/FS-MCP/commits/v1.0.0