mcp-filesystem-server

Vamsiindugu/mcp-filesystem-server

3.1

If you are the rightful owner of mcp-filesystem-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The MCP Filesystem Server is a robust and flexible server designed for advanced filesystem operations, providing a suite of tools for file management and version control.

Tools
11
Resources
0
Prompts
0

MCP Filesystem Server

A powerful and extensible MCP server for advanced filesystem operations.

This server provides a set of tools to interact with the filesystem, including file searching, analysis, manipulation, and version control with Git.

Features

  • File Search: Search for files using glob patterns (search_files).
  • File Analysis: Analyze file properties like size, encoding, and line count (analyze_file).
  • Directory Tree: Generate a visual directory tree structure (directory_tree).
  • Batch Rename: Rename multiple files at once (batch_rename).
  • Content Search: Search for text within files using regular expressions (search_content).
  • File Compression: Compress files and directories into .zip or .tar.gz archives (compress_files).
  • File Decompression: Extract files from archives (decompress_files).
  • Permission Management: View and modify file permissions (manage_permissions).
  • Git Integration: Get Git repository status and logs (git_status, git_log).
  • File Watching: Monitor files and directories for changes (watch_files).

Installation

You can install the MCP Filesystem Server using pip:

pip install mcp-filesystem-server

▶️ Usage

To run the server, execute the main script from the project's root directory. The server will start and be ready to receive requests from an MCP client over stdio.

pip install git+https://github.com/Vamsiindugu/mcp-filesystem-server.git

Alternatively, if installed as a package, you can use the entry point defined in pyproject.toml:

uv run mcp-filesystem-server

Once running, any MCP-compatible client can connect to it and call the tools listed in the Tool Reference.

🤝 Contributing

Contributions, issues, and feature requests are welcome!

  1. Fork the Project.
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature).
  3. Commit your Changes (git commit -m 'Add some AmazingFeature').
  4. Push to the Branch (git push origin feature/AmazingFeature).
  5. Open a Pull Request.

📝 License

Distributed under the MIT License. See LICENSE for more information.