🎉 MCP Server Filesystem v1.1.0 - NPM Package Release

🎉 MCP Server Filesystem v1.1.0 - NPM Package Release

🌟 What's New

📦 NPM Package Available

• Published as @redf0x1/mcp-server-filesystem
• Zero-installation usage with npx
• Global installation support
• Professional scoped package namespace

🚀 Enhanced User Experience

• Easy Installation: npm install -g @redf0x1/mcp-server-filesystem
• Instant Usage: npx @redf0x1/mcp-server-filesystem /workspace
• No Repository Cloning: Direct package installation
• Automatic Updates: Standard npm update workflow

📋 Quick Start

# NPX (No installation needed)
npx @redf0x1/mcp-server-filesystem /your/workspace

# Global installation  
npm install -g @redf0x1/mcp-server-filesystem
mcp-server-filesystem /your/workspace

🔧 MCP Client Configuration

VS Code MCP Extension:

{
  "servers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@redf0x1/mcp-server-filesystem", "/workspace"]
    }
  }
}

Cursor IDE:

{
  "mcp": {
    "servers": {
      "filesystem": {
        "command": "npx", 
        "args": ["-y", "@redf0x1/mcp-server-filesystem", "/workspace"]
      }
    }
  }
}

✨ Core Features

• 🔧 Fixed Head+Tail: Read first N + last M lines simultaneously
• 🔍 Proper Glob Search: *config*, **/*.js, *test* patterns work correctly
• 🗑️ Safe File Deletion: Recursive directory deletion with validation
• ⚡ Command Execution: Secure shell commands within allowed directories
• 📝 Git-style Diffs: Preview file edits before applying
• 🛡️ Enhanced Security: Path validation, symlink protection, input sanitization

🆚 Comparison with Official MCP Filesystem

Feature	Official MCP	Our Enhanced Version
Glob Patterns	❌ Basic includes()	✅ Full minimatch support
Head + Tail	❌ "Cannot specify both" error	✅ Smart combination
File Deletion	❌ Basic unlink only	✅ Recursive with safety checks
Command Execution	❌ Not available	✅ Secure shell execution
Diff Preview	❌ No preview	✅ Git-style diffs
Error Messages	❌ Basic errors	✅ Detailed troubleshooting

📊 Package Stats

• Size: 14.3 kB package, 55.0 kB unpacked
• Dependencies: 5 production dependencies
• Node.js: >=18.0.0 required
• License: MIT
• Maintenance: Actively maintained

🔗 Links

• 📦 NPM Package: https://www.npmjs.com/package/@redf0x1/mcp-server-filesystem
• 📚 Documentation: README.md
• 🐛 Issues: GitHub Issues
• 💡 Feature Requests: Discussions

🙏 Community

• ⭐ Star this repo if you find it useful
• 🐛 Report bugs via GitHub Issues
• 💡 Request features via GitHub Discussions
• 🤝 Contribute via Pull Requests

---

Full Changelog: v1.0.1...v1.1.0

🎉 Enhanced MCP Filesystem Server v1.0.0

🌟 First Release: Enhanced MCP Filesystem Server

This release provides a complete, enhanced MCP filesystem server that fixes critical limitations found in standard implementations.

✨ Key Features

🔧 Fixed Issues:

• ✅ Head + Tail Support: Read first N lines AND last M lines simultaneously
• ✅ Proper Glob Patterns: *pipeline*, *.js, **/*test* work correctly
• ✅ Enhanced File Operations: Git-style diff preview for edits

🚀 New Tools:

• delete_file - Safe file/directory deletion with recursive option
• run_command - Secure shell command execution
• Enhanced search_files with proper glob pattern support

📦 Installation

git clone https://github.com/redf0x1/MCP-Server-Filesystem.git
cd MCP-Server-Filesystem
npm install
node server-filesystem.js /path/to/your/workspace

🔧 MCP Client Support

• VS Code MCP Extension
• Cursor IDE
• Cline (Claude for VSCode)
• Windsurf AI Editor
• Generic MCP clients

📚 Documentation

Complete setup guides and configuration examples are available in the README.

🆚 What's Different?

This server addresses specific limitations in standard MCP filesystem implementations:

• Fixed "Cannot specify both head and tail parameters" error
• Proper glob pattern matching with minimatch
• Safe recursive file deletion
• Enhanced error handling with context
• Comprehensive multi-client documentation

---

Full Changelog: https://github.com/redf0x1/MCP-Server-Filesystem/blob/main/CHANGELOG.md