🗂️ 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