RemoteZip

Remote zip mcp server

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "yuriyo-remotezip-mcp": {
      "command": "remotezip-mcp",
      "args": [],
      "env": {
        "PATH": "$PATH"
      }
    }
  }
}

You set up and run a Model Context Protocol (MCP) server that lets you inspect and extract files from remote zip archives over HTTP, HTTPS, or FTP without downloading the entire archive. This server is useful when you need quick access to file listings, single-file extraction, or file metadata from large remote ZIPs.

How to use

You interact with the RemoteZip MCP Server through an MCP client. The server exposes operations to list files inside a remote ZIP, extract individual files on demand, and retrieve information and statistics about the archive. Start the server locally and then connect your MCP client to it using the standard MCP connection flow. Use the client’s file listing and extraction features to work with specific files without pulling the whole archive.

How to install

Prerequisites include Python 3.10 or higher. You also need a working environment to install Python packages and run commands.

# Install Python 3.10+
# Install the MCP server package
pip install remotezip_mcp-1.0.0-py3-none-any.whl

Configuration and running the MCP server

You can run the MCP server directly from the installed command. The standard runtime command is remotezip-mcp. Start it to listen for MCP client connections on the default port.

remotezip-mcp

Additional notes and troubleshooting

If you prefer running the server via a script during development, you can also start the server with Python directly using the provided script: python remotezip_server.py. The installed command remotezip-mcp provides the same MCP server functionality.

Common issues include making sure the executable is in your PATH and that you have the required Python version. If the server does not start, verify the installation and try running with a help option such as remotezip-mcp --help to confirm available commands and usage.

Security considerations

Run the MCP server in a trusted environment and limit access to MCP clients as appropriate for your setup. If you expose the server over a network, ensure that you use secure transport where possible and monitor access logs for unusual activity.

Tools

The server provides the following capabilities for remote zip archives:

list_files(url) -> Get list of files in the archive
extract_file(url, filename, local_path) -> Extract a specific file to local storage
get_file_info(url, filename) -> Get details about a specific file
get_zip_statistics(url) -> Get overall statistics of the archive

Available tools

list_files

Return the list of files contained in a remote ZIP archive without downloading the whole file.

extract_file

Extract a single file from a remote ZIP archive to a local path without fetching the entire archive.

get_file_info

Retrieve metadata and statistics for a specific file inside a remote ZIP archive.

get_zip_statistics

Provide overall statistics about the remote ZIP archive, such as size and file counts.