MCP Utils

March 31, 2025 ยท View on GitHub

ไธญๆ–‡ | 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 ๐Ÿ“ง

Credits ๐Ÿ’–

This project is inspired by zip-mcp and fastmcp.

License

MIT License ยฉ Lm905