Repository navigation
🎉 Initial Release
We're excited to announce the first public release of FastMCP File Server - a secure, versatile file server implementing the Model Context Protocol (MCP) for AI assistants.
✨ What's New
Core Features
- Comprehensive File Operations: Full CRUD operations for files and directories
- Advanced Text Manipulation: Line-specific operations, search/replace, pattern matching
- File Analysis Tools: Metadata, hashing, diff generation, permissions checking
- Batch Operations: Efficient multi-file operations
- Archive Support: ZIP file creation and extraction
- Format Conversion: Text to PDF, image conversion, CSV ↔ JSON
Security & Access Control
- Multi-tier Authentication: Read-only, Read/Write, and Admin access levels
- HTTP Security Warning: Prevents accidental unprotected server exposure
- Directory Restrictions: All operations confined to configured safe directories
- Token-based Authentication: Secure Bearer token system for HTTP mode
Connection Modes
- Stdio Mode: Direct integration with Claude Desktop
- HTTP Mode: Local server with REST API
- Public Access: ngrok integration for web-based AI systems
Developer Experience
- Easy Installation: Available on PyPI with simple uv tool install or pip install
- Flexible Configuration: Environment variables and .env file support
- Comprehensive Documentation: Detailed setup guides and API reference
- CLI Commands: fastmcp-file-server and fastmcp-file-server-http entry points
🛠️ Technical Details
- Python 3.10+ support
- MIT License
- Built on the fastmcp framework
- Comprehensive test suite with pytest
- Code formatting with Black and Ruff
- Ready for production deployment
📦 Installation
Using uv (recommended)
uv tool install fastmcp-file-server
Using pip
pip install fastmcp-file-server
🔗 Resources
- PyPI Package: https://pypi.org/project/fastmcp-file-server/
- GitHub Repository: https://github.com/Luxshan2000/Local-File-MCP-Server
- Documentation: Complete setup guides and API reference in README.md
🙏 Acknowledgments
This release represents a comprehensive file server solution for AI assistants, with security and flexibility as primary design goals.
Thank you to all contributors and early adopters!