Mcp7zOp

You run a local MCP server that exposes 7-Zip command line operations as MCP endpoints. This lets you create, extract, inspect, and modify archives, as well as perform basic file system queries, using familiar MCP tooling and workflows.

How to use

You interact with the MCP server through an MCP client by invoking the available tools to manage archives and related file system tasks. Typical workflows include creating archives from multiple files or folders, extracting archives to a target directory, listing items within an archive, and adding, replacing, or removing items from archives. You can also query directory contents and get detailed path information or existence checks to prepare inputs for archive creation.

How to install

Prerequisites:
- Python >= 3.10
- 7-Zip >= 23.0
- uvx package manager (used to install and run the MCP server)

1) Install 7-Zip from the official source and ensure the 7z executable is available
2) Install uvx (uv) if you have not already
3) Install the MCP server package from its repository
   uv tool install git+{repository_URL}
4) Run the MCP server to verify it exposes tools
   mcp7zop

Registering the MCP server with your Agent

Register the MCP server so your client tools can discover and communicate with it. The example below shows how you would reference the server within your Agent configuration. Adjust the wiring to match your Agent’s configuration method.

{
  // Example configuration file for Agent tool
  // ** Please refer to the Agent documentation for configuration methods. **
  "mcpServers": { 
    "mcp7zop": {
      "type": "stdio",
      "command": "mcp7zop",
      "args": [
        "--mcp-server"
      ]
    }
  }
}

Configuration and startup notes

The server relies on 7-Zip being available in your environment. You can either add the 7-Zip executable’s directory to your system PATH or explicitly configure the path to 7-Zip in a configuration file. Example configuration file path and content:

{
  "7z_path": "/path/to/7z_executable"
}

Available tools

mcp7zop_make_archive

Creates an archive from multiple files and directories. Returns the path to the created archive.

mcp7zop_extract_archive

Extracts an archive to a specified directory. Returns a list of extracted file paths.

mcp7zop_get_archive_item_list

Lists items contained in an archive and returns item metadata.

mcp7zop_replace_archive_items

Adds or replaces files and directories inside an existing archive. Returns the updated archive path.

mcp7zop_remove_archive_items

Removes specified items from an archive. Returns the updated archive path.

mcp7zop_get_dir_item_list

Lists items within a specified directory and returns names and types.

mcp7zop_get_path_item_info

Provides detailed information about a specific path item.

mcp7zop_path_is_exist

Checks whether a given path exists and returns a boolean.