Includes automated release workflows that build and release Python packages when version tags are pushed to GitHub repositories
Provides tools for accessing remote zip files over HTTP, HTTPS, and FTP protocols, allowing file listing, extraction, and statistics without downloading entire archives
RemoteZip MCP Server
An MCP server that provides tools for accessing remote zip files over HTTP, HTTPS, and FTP protocols without downloading the entire archive.
Features
- List files in remote zip archives
- Extract individual files from remote zip archives
- Get file information and statistics
- Support for HTTP, HTTPS, and FTP protocols
- Partial reading - only downloads necessary parts of the zip file
Installation
From Source
- Install Python 3.10 or higher
- Clone the repository:
- Install dependencies:
From GitHub Releases
Download the latest release from the Releases page and install:
Usage
Run the server:
Or use the installed command:
Tools
list_files(url)
: Get list of files in the archiveextract_file(url, filename, local_path)
: Extract a file to local storageget_file_info(url, filename)
: Get details about a specific fileget_zip_statistics(url)
: Get overall statistics of the archive
Development
Setup Development Environment
Running Tests
Creating Releases
Use the provided release script:
This will:
- Create a git tag
r1.0.0
- Push the tag to GitHub
- Trigger GitHub Actions to build and release
GitHub Actions
The repository includes automated release workflows:
- Release Workflow (
.github/workflows/release.yml
): Automatically builds and releases when version tags are pushed - Triggers on tags matching pattern
r*
- Builds Python wheel and source distribution
- Creates GitHub release with generated release notes
Dependencies
remotezip
: For partial reading of remote zip filesmcp
: Model Context Protocol frameworkfastmcp
: FastMCP server implementation
License
MIT License - see LICENSE file for details
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables accessing and extracting files from remote zip archives over HTTP, HTTPS, and FTP without downloading the entire archive. Supports listing files, extracting individual files, and getting file information using partial reading techniques.