Skip to content

🎉 MCP Server Filesystem v1.1.0 - NPM Package Release

Latest

Choose a tag to compare

@redf0x1 redf0x1 released this 24 Jul 05:18
· 3 commits to main since this release

🎉 MCP Server Filesystem v1.1.0 - NPM Package Release

NPM Version
NPM Downloads
GitHub Stars

🌟 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

🙏 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