MCP Utils

中文 | English

Project Introduction 🚀

MCP Utils is a comprehensive toolset based on Model Context Protocol (MCP) providing ZIP compression/decompression and WebP image conversion. Built with fastMCP, zip.js, and sharp.

Features ✨

• ZIP File Management:
  • Compression/decompression with password protection
  • Multi-file packaging with compression level control (0-9)
  • Metadata query for ZIP archives
• Image Processing:
  • WebP conversion with quality and compression settings
• Extensible Framework:
  • Modular design with clear API interfaces

Installation 📦

git clone <repository-url>
cd mcp-utils
npm install
npm run json

Generated MCP JSON:

{
  "mcpServers": {
    "mcp-utils": {
      "command": "npx",
      "args": [
        "tsx",
        "<ABSOLUTE PATH>src/index.ts"
      ]
    }
  }
}

MCP Tools 🛠️

compress

Compress files/directories into ZIP format with optional password protection.

decompress

Extract ZIP archives with password support.

getZipInfo

Get detailed metadata from ZIP archives.

convertToWebP

Convert images to WebP format with quality control.

echo

Test tool that returns the input message.

Usage Examples 💡

// Compress files
await client.executeTool("compress", {
  input: "/path/to/files",
  output: "/path/to/output.zip",
  options: { level: 9, password: "secret" }
});

// Decompress files
await client.executeTool("decompress", {
  input: "/path/to/archive.zip",
  output: "/path/to/extract",
  options: { password: "secret" }
});

// Convert image to WebP
await client.executeTool("convertToWebP", {
  input: "/path/to/image.jpg",
  output: "/path/to/image.webp",
  options: { quality: 85 }
});

Future Plans 🔮

• PDF processing tools
• Text and document processing
• Advanced image processing
• Audio and video utilities

Contact 📧

• Email: [email protected]

Credits 💖

This project is inspired by zip-mcp and fastmcp.

License

MIT License © Lm905