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:

git clone https://github.com/yourusername/remotezip-mcp.git
cd remotezip-mcp

Install dependencies:
```
pip install -e .
```

From GitHub Releases

Download the latest release from the Releases page and install:

pip install remotezip_mcp-1.0.0-py3-none-any.whl

MCP Server Configuration

For VSCode

Install the MCP extension:
- Search for "MCP (Model Context Protocol)" in VSCode extensions
- Install the extension by Anthropic
Create MCP configuration file:
- Create the file ~/.vscode/mcp.json (on macOS/Linux) or %APPDATA%\Code\User\mcp.json (on Windows)
- Or use the global config: ~/.config/mcp/mcp.json
Add the following configuration to your mcp.json:

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

Restart VSCode to load the MCP server

For Cursor

Open Cursor settings:
- Press Cmd/Ctrl + , to open settings
- Or go to File → Preferences → Settings
Navigate to MCP settings:
- Search for "mcp" in the settings search bar
- Look for "MCP: Servers" or "Model Context Protocol" section
Add a new MCP server with these exact settings:

Name: RemoteZip MCP Server
Command: remotezip-mcp
Arguments: Leave this field empty
Environment Variables: (optional)

Save and restart Cursor to activate the MCP server

Alternative: Manual MCP Configuration

If your editor doesn't have built-in MCP support, you can also run the server manually:

# Start the MCP server
remotezip-mcp

Then connect to it using your MCP client with the server running on the default port.

Troubleshooting

Command not found: Make sure remotezip-mcp is in your PATH after installation
Permission denied: Try running with sudo or check file permissions
Server won't start: Verify the installation with remotezip-mcp --help
Configuration not loading: Check the JSON syntax in your mcp.json file

Usage

Run the server:

python remotezip_server.py

Or use the installed command:

remotezip-mcp

Tools

list_files(url): Get list of files in the archive
extract_file(url, filename, local_path): Extract a 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

Development

Setup Development Environment

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install in development mode
pip install -e .

Running Tests

# Run the MCP server
python remotezip_server.py

Creating Releases

Use the provided release script:

./release.sh 1.0.0

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 files
mcp: Model Context Protocol framework
fastmcp: FastMCP server implementation

License

MIT License - see LICENSE file for details