Mac2win Zip MCP
MCP Server for creating Windows-compatible ZIP files from macOS
Installation
npx mac2win-zip-mcpAsk AI about Mac2win Zip MCP
Powered by Claude Β· Grounded in docs
I know everything about Mac2win Zip MCP. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
mac2win-zip MCP Server
Create Windows-compatible ZIP files from macOS via MCP
An MCP (Model Context Protocol) server for creating Windows-compatible ZIP files.
This MCP server wraps the functionality of mac2win-zip to create ZIP files that work perfectly on Windows from macOS.
Why mac2win-zip MCP Server?
The Problem
macOS uses NFD (Normalization Form Decomposed) for Unicode filenames, while Windows uses NFC (Normalization Form Composed). When you create a ZIP file on macOS containing files with Unicode characters (like Korean, Japanese, or special characters), Windows users often see garbled filenames.
| macOS (ZIP created) | Windows (ZIP opened) |
|---|---|
| π Hello?.pdf | β (removed) |
| π μλ νμΈμ μΈμ.pdf | β (removed) |
The Solution
This MCP server automatically:
- Normalizes all filenames from NFD to NFC
- Removes or replaces Windows-forbidden characters
- Excludes macOS-specific files (
.DS_Store, etc.) - Preserves the folder structure
Result: ZIP files that work perfectly on both macOS and Windows!
| macOS (ZIP created) | Windows (ZIP opened) |
|---|---|
| π Hello.pdf | β Hello.pdf |
| π μλ νμΈμ μΈμ.pdf | β μλ νμΈμ μΈμ.pdf |
Installation
Quick Start - One Command! π
The easiest way to add this MCP server to Claude Desktop:
claude mcp add --transport stdio mac2win-zip -- uvx mac2win-zip-mcp
That's it! Restart Claude Desktop and it's ready to use.
For Developers
Contributing or developing? Clone and install in editable mode:
git clone https://github.com/Wordbe/mac2win-zip-mcp.git
cd mac2win-zip-mcp
uv pip install -e ".[dev]"
Usage
MCP Tools
This server provides the following tools:
create_windows_compatible_zip
Create a Windows-compatible ZIP file from files and/or folders.
Parameters:
paths(array, required): List of file or folder paths to zipoutput(string, optional): Output ZIP filename (default: "archive.zip")working_dir(string, optional): Base directory for relative paths
Example usage:
Create a Windows-compatible ZIP of the current directory
Paths: ["."]
Output: "backup.zip"
validate_zip_for_windows
Validate if a ZIP file is Windows-compatible.
Parameters:
zip_path(string, required): Path to the ZIP file to validateworking_dir(string, optional): Base directory for relative path
Example usage:
Check if a ZIP file is Windows-compatible
ZIP Path: "archive.zip"
Example Usage
Once configured in Claude Desktop, simply ask Claude in natural language:
Create a Windows-compatible ZIP:
Create a Windows-compatible ZIP of my Documents folder.
Validate an existing ZIP:
Check if backup.zip is Windows-compatible.
Batch processing:
Create Windows-compatible ZIPs for all folders in ~/Projects
Claude will automatically use the MCP tools to create properly formatted ZIP files that work perfectly on Windows!
Features
- Unicode Normalization: Converts macOS NFD filenames to Windows-compatible NFC
- Character Sanitization: Removes Windows-forbidden characters (
<>:"|?*\) - Auto Recursive: Automatically includes all subdirectories when zipping folders
- Smart Naming: Creates
folder-name.zipby default (no -o needed for single folder) - Structure Preservation: Maintains original folder hierarchy in ZIP
- Smart Filtering: Excludes hidden files (
.DS_Store, etc.) - Korean Support: Perfect handling of Korean and other Unicode filenames
- MCP Protocol: Works with any MCP-compliant AI assistant (Claude, etc.)
Requirements
- uv - Fast Python package runner
- Install:
brew install uvorcurl -LsSf https://astral.sh/uv/install.sh | sh
- Install:
- Claude Desktop (or any MCP-compatible AI assistant)
Note: Python is NOT required! uvx automatically downloads and manages Python 3.10+ for you.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Architecture
This MCP server is a thin wrapper around the mac2win-zip library, exposing its functionality via the Model Context Protocol. This means:
- Single source of truth: Core ZIP creation logic lives in
mac2win-zip - Always in sync: Updates to
mac2win-zipautomatically benefit this MCP server - Separation of concerns: CLI tool and MCP server share the same battle-tested code
Related Projects
- mac2win-zip - CLI tool for creating Windows-compatible ZIP files (core library)
- Model Context Protocol - The protocol powering this server
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Bug Reports
If you discover any bugs, please create an issue on GitHub with:
- Your operating system and version
- Python version
- MCP client information
- Steps to reproduce the bug
- Expected vs actual behavior
Show Your Support
If this project helped you, please give it a star!
Made with β€οΈ by Wordbe for seamless macOS-Windows file sharing
