image-processor-mcp 0.1.0 → 0.1.2

package/build/config/app.config.js

@@ -1,4 +1,4 @@
 export const APP_CONFIG = {
     name: 'image-processor-mcp',
-    version: '0.1.0',
+    version: '0.1.2',
 };

package/package.json

@@ -1,9 +1,17 @@
 {
   "name": "image-processor-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "description": "MCP server for downloading, compressing, and optimizing images with batch directory processing and auto-generated reports",
   "main": "build/index.js",
+  "bin": {
+    "image-processor-mcp": "./build/index.js"
+  },
+  "files": [
+    "build/",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "tsc",
     "lint": "tsc --noEmit",
@@ -13,7 +21,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/pansuriyadhvanil/mcp-image-downloader.git"
+    "url": "git+https://github.com/pansuriyadhvanil/Image-Processor-MCP.git"
   },
   "keywords": [
     "mcp",

package/.github/workflows/ci.yml

@@ -1,30 +0,0 @@
-name: CI/CD Pipeline
-
-on:
-  push:
-    branches: [ main ]
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  build-and-test:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout Code
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          cache: 'npm'
-
-      - name: Install Dependencies
-        run: npm ci
-
-      - name: Lint Code
-        run: npm run lint
-
-      - name: Build Project
-        run: npm run build

package/.github/workflows/publish.yml

@@ -1,34 +0,0 @@
-name: Publish to NPM
-
-on:
-  push:
-    tags:
-      - 'v*'
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      id-token: write
-
-    steps:
-      - name: Checkout Code
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Install Dependencies
-        run: npm install
-
-      - name: Build Project
-        run: npm run build
-
-      - name: Publish to NPM
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/NPM_PUBLISH_GUIDE.md

@@ -1,73 +0,0 @@
-# Automated NPM Publishing Workflow
-
-This guide explains how to publish new versions of this MCP server to the NPM registry using GitHub Actions.
-
-## Prerequisites
-
-### Option A: Granular Access Token (Recommended for simplicity)
-
-1. **Generate Token**:
-   - Login to [npmjs.com](https://www.npmjs.com/).
-   - Navigate to **Access Tokens** > **Generate New Token** > **Granular Access Token**.
-   - **Name**: `GitHub-Actions-Image-Processor-MCP`.
-   - **Expiration**: Set as needed (e.g., 365 days).
-   - **Permissions**:
-     - **Read and Write** for the specific package.
-   - **Bypass 2FA**: Check this if your account has 2FA enabled, otherwise the automated workflow will fail.
-   - Copy the generated token.
-
-2. **Add GitHub Secret**:
-   - Go to your GitHub repository.
-   - Navigate to **Settings** > **Secrets and variables** > **Actions**.
-   - Click **New repository secret**.
-   - **Name**: `NPM_TOKEN`
-   - **Value**: Paste the token from NPM.
-
-### Option B: Trusted Publishing (OIDC) - More Secure
-
-1. **Configure NPM**:
-   - In your NPM package settings, navigate to **Publishing** > **Trusted Publishing**.
-   - Add a new GitHub Actions publisher.
-   - Provide your repository name.
-
-2. **Workflow Permissions**:
-   The `.github/workflows/publish.yml` already has:
-   ```yaml
-   permissions:
-     id-token: write
-     contents: read
-   ```
-
----
-
-## How to Release a New Version
-
-The workflow triggers automatically when you push a new version tag (starting with `v`).
-
-### 1. Update Version
-Update the `version` field in your `package.json`.
-
-### 2. Commit and Push
-```bash
-git add package.json
-git commit -m "chore: bump version to 0.1.1"
-git push origin main
-```
-
-### 3. Create and Push a Version Tag
-```bash
-git tag v0.1.1
-git push origin v0.1.1
-```
-
----
-
-## What Happens Behind the Scenes?
-
-1. GitHub Actions detects the new tag `v*`.
-2. A fresh Ubuntu runner is provisioned.
-3. The project is built using `npm run build`.
-4. The package is published to NPM using `NPM_TOKEN`.
-5. You will receive an email from NPM once the publish is successful.
-
-You can monitor progress in the **Actions** tab of your GitHub repository.

package/src/config/app.config.ts

@@ -1,4 +0,0 @@
-export const APP_CONFIG = {
-  name: 'image-processor-mcp',
-  version: '0.1.0',
-};

package/src/config/config.constants.ts

@@ -1,181 +0,0 @@
-export const DEFAULTS = {
-  quality: 85,
-  lossless: false,
-  effort: 6,
-  maxDimension: 2000,
-  expectedSizeKB: 100,
-  qualityStepDown: 5,
-  minimumQualityFloor: 10,
-  outputFormat: 'webp',
-  filenameCase: 'lowercase' as const,
-  dirnameCase: 'lowercase' as const,
-  filenameReplaceChars: [' ', '-', '.', '&'],
-  dirnameReplaceChars: [' ', '-', '.', '&'],
-};
-
-export const SUPPORTED_EXTENSIONS = [
-  '.jpg', '.jpeg', '.png', '.gif', '.bmp', '.tiff', '.tif',
-  '.webp', '.avif', '.svg', '.heic', '.heif', '.ico', '.cur',
-  '.jp2', '.j2k', '.jpf', '.jpx', '.jpm', '.mj2',
-  '.jxr', '.wdp', '.hdp',
-  '.psd', '.psb',
-  '.dds',
-  '.tga', '.vda', '.icb', '.vst',
-  '.pbm', '.pgm', '.ppm', '.pnm', '.pfm',
-  '.exr',
-  '.hdr', '.hrd',
-  '.pic', '.pict', '.pct',
-  '.xbm', '.xpm',
-  '.wal',
-  '.cut',
-  '.ras', '.sun',
-  '.sgi', '.rgb', '.rgba', '.bw',
-  '.pcx',
-  '.pcd',
-  '.iff', '.lbm',
-];
-
-export const SUPPORTED_OUTPUT_FORMATS = [
-  'webp', 'avif', 'jpeg', 'png', 'tiff', 'gif',
-  'heif', 'jp2', 'jxl', 'pdf',
-];
-
-export interface ConfigDescription {
-  name: string;
-  default: string | number | boolean | string[];
-  description: string;
-}
-
-export const CONFIG_DESCRIPTIONS: ConfigDescription[] = [
-  {
-    name: 'quality',
-    default: DEFAULTS.quality,
-    description: 'Compression quality level for lossy formats (1-100). Higher values preserve more detail but produce larger files. Used for JPEG, WebP, AVIF, and HEIF output.',
-  },
-  {
-    name: 'lossless',
-    default: DEFAULTS.lossless,
-    description: 'When true, uses lossless compression. File sizes will be larger but pixel data is preserved exactly. Supported for WebP, PNG, GIF, and AVIF formats.',
-  },
-  {
-    name: 'effort',
-    default: DEFAULTS.effort,
-    description: 'CPU effort level (0-6). Higher values produce better compression ratios but take significantly longer to process. Level 6 gives the smallest file size.',
-  },
-  {
-    name: 'maxDimension',
-    default: DEFAULTS.maxDimension,
-    description: 'Maximum width or height in pixels. Images exceeding this threshold are automatically resized down to fit while maintaining aspect ratio. Set to a high value to effectively disable.',
-  },
-  {
-    name: 'expectedSizeKB',
-    default: DEFAULTS.expectedSizeKB,
-    description: 'Target file size in KB for recursive compression. If the compressed output exceeds this size, quality is reduced iteratively until the target is met or minimumQualityFloor is reached.',
-  },
-  {
-    name: 'qualityStepDown',
-    default: DEFAULTS.qualityStepDown,
-    description: 'Amount to reduce quality by in each recursive compression iteration. Larger values reach target size faster but risk visible quality degradation.',
-  },
-  {
-    name: 'minimumQualityFloor',
-    default: DEFAULTS.minimumQualityFloor,
-    description: 'Lowest quality value (1-100) allowed during recursive compression. Prevents excessive degradation even if the target file size is not reached.',
-  },
-  {
-    name: 'outputFormat',
-    default: DEFAULTS.outputFormat,
-    description: 'Default output image format. WebP offers excellent compression with good quality. AVIF gives better compression but slower encoding. JPEG offers universal compatibility.',
-  },
-  {
-    name: 'filenameCase',
-    default: DEFAULTS.filenameCase,
-    description: 'Case conversion applied to filenames when normalization is enabled. lowercase converts all to lower, uppercase converts all to UPPER, original leaves them as-is.',
-  },
-  {
-    name: 'dirnameCase',
-    default: DEFAULTS.dirnameCase,
-    description: 'Case conversion applied to directory names when normalization is enabled. Same options as filenameCase: lowercase, uppercase, or original.',
-  },
-  {
-    name: 'filenameReplaceChars',
-    default: DEFAULTS.filenameReplaceChars,
-    description: 'Array of characters replaced with underscores in filenames when normalization is enabled. Helps create web-safe filenames by removing spaces and special characters.',
-  },
-  {
-    name: 'dirnameReplaceChars',
-    default: DEFAULTS.dirnameReplaceChars,
-    description: 'Array of characters replaced with underscores in directory names when normalization is enabled. Helps create web-safe directory names.',
-  },
-];
-
-export const INPUT_EXTENSION_DESCRIPTIONS: Record<string, string> = {
-  '.jpg': 'JPEG image (Joint Photographic Experts Group)',
-  '.jpeg': 'JPEG image (alternative extension)',
-  '.png': 'PNG image (Portable Network Graphics)',
-  '.gif': 'GIF image (Graphics Interchange Format)',
-  '.bmp': 'BMP image (Bitmap)',
-  '.tiff': 'TIFF image (Tagged Image File Format)',
-  '.tif': 'TIFF image (alternative extension)',
-  '.webp': 'WebP image (Google web format)',
-  '.avif': 'AVIF image (AV1 Image File Format)',
-  '.svg': 'SVG vector image (Scalable Vector Graphics)',
-  '.heic': 'HEIC image (High Efficiency Image Container)',
-  '.heif': 'HEIF image (High Efficiency Image File Format)',
-  '.ico': 'ICO icon file (Windows icon)',
-  '.cur': 'CUR cursor file (Windows cursor)',
-  '.jp2': 'JPEG 2000 image',
-  '.j2k': 'JPEG 2000 image (alternative extension)',
-  '.jpf': 'JPEG 2000 image (alternative extension)',
-  '.jpx': 'JPEG 2000 extended image',
-  '.jpm': 'JPEG 2000 compound image',
-  '.mj2': 'Motion JPEG 2000',
-  '.jxr': 'JPEG XR image (Microsoft HD Photo)',
-  '.wdp': 'Windows Media Photo (JPEG XR)',
-  '.hdp': 'HD Photo (JPEG XR)',
-  '.psd': 'Photoshop document',
-  '.psb': 'Photoshop large document',
-  '.dds': 'DirectDraw Surface texture',
-  '.tga': 'Targa image',
-  '.vda': 'Targa image (alternative extension)',
-  '.icb': 'Targa image (alternative extension)',
-  '.vst': 'Targa image (alternative extension)',
-  '.pbm': 'Portable Bitmap (black and white)',
-  '.pgm': 'Portable Graymap (grayscale)',
-  '.ppm': 'Portable Pixmap (color)',
-  '.pnm': 'Portable Anymap (generic PPM/PGM/PBM)',
-  '.pfm': 'Portable FloatMap (HDR)',
-  '.exr': 'OpenEXR HDR image (Industrial Light & Magic)',
-  '.hdr': 'Radiance HDR image',
-  '.hrd': 'Radiance HDR image (alternative extension)',
-  '.pic': 'PICT image (Apple QuickDraw)',
-  '.pict': 'PICT image (alternative extension)',
-  '.pct': 'PICT image (alternative extension)',
-  '.xbm': 'X BitMap (X11)',
-  '.xpm': 'X PixMap (X11)',
-  '.wal': 'Quake 2 texture (WAL format)',
-  '.cut': 'CUT image (Dr. Halo)',
-  '.ras': 'Sun Raster image',
-  '.sun': 'Sun Raster image (alternative extension)',
-  '.sgi': 'SGI image (Silicon Graphics)',
-  '.rgb': 'SGI RGB image',
-  '.rgba': 'SGI RGBA image',
-  '.bw': 'SGI black and white image',
-  '.pcx': 'PCX image (ZSoft PC Paintbrush)',
-  '.pcd': 'PhotoCD image (Kodak)',
-  '.iff': 'IFF image (Amiga Interchange File Format)',
-  '.lbm': 'IFF image (alternative extension)',
-};
-
-export const OUTPUT_FORMAT_DESCRIPTIONS: Record<string, string> = {
-  webp: 'Google WebP. Modern format with excellent lossy and lossless compression. Best all-around choice for web use. Supports transparency.',
-  avif: 'AVIF based on AV1 codec. Superior compression ratios (30-50% smaller than JPEG) but slower encoding. Best for modern browsers.',
-  jpeg: 'JPEG. Universal compatibility with all devices and software. Good for photographs. Does not support transparency.',
-  png: 'PNG. Lossless compression with full transparency support. Best for graphics, logos, screenshots, and images requiring sharp edges.',
-  tiff: 'TIFF. High-quality format commonly used in print and publishing. Supports layers and multiple pages. Largest file sizes.',
-  gif: 'GIF. Supports animation and transparency. Limited to 256 colors. Best for simple animations and low-color graphics.',
-  heif: 'HEIF (High Efficiency Image File Format). Modern format using HEVC codec. Better compression than JPEG. Apple ecosystem support.',
-  jp2: 'JPEG 2000. Wavelet-based compression with excellent quality. Used in medical imaging and digital cinema. Not widely supported in browsers.',
-  jxl: 'JPEG XL. Next-gen format designed to replace JPEG. Lossless re-encoding of existing JPEGs. Excellent compression. Growing browser support.',
-  pdf: 'PDF (Portable Document Format). Converts images to PDF pages. Useful for document creation and archiving.',
-};

package/src/controllers/tool.controller.ts

@@ -1,255 +0,0 @@
-import fs from 'fs-extra';
-import axios from 'axios';
-import path from 'path';
-import { FileService } from '../services/file.services.js';
-import { ImageService } from '../services/image.services.js';
-import { ReportService } from '../services/report.services.js';
-import type { DownloadImageArgs, CompressImageArgs, CompressDirectoryArgs, FileNamingOptions } from '../types.js';
-import {
-  DEFAULTS,
-  CONFIG_DESCRIPTIONS,
-  SUPPORTED_EXTENSIONS,
-  INPUT_EXTENSION_DESCRIPTIONS,
-  SUPPORTED_OUTPUT_FORMATS,
-  OUTPUT_FORMAT_DESCRIPTIONS,
-} from '../config/config.constants.js';
-import { APP_CONFIG } from '../config/app.config.js';
-
-export class ToolController {
-  static async handleDownloadImage(args: DownloadImageArgs) {
-    try {
-      await fs.ensureDir(path.dirname(args.outputPath));
-      const response = await axios({
-        method: 'GET',
-        url: args.url,
-        responseType: 'arraybuffer',
-        headers: {
-          'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36',
-        },
-        timeout: 30000,
-      });
-      await fs.writeFile(args.outputPath, response.data);
-      return {
-        content: [{ type: 'text', text: `Successfully downloaded image to ${args.outputPath}` }],
-      };
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
-      console.error('Download error:', errorMessage);
-      return { content: [{ type: 'text', text: `Failed to download image: ${errorMessage}` }], isError: true };
-    }
-  }
-
-  static async handleCompressImage(args: CompressImageArgs) {
-    try {
-      await FileService.ensureDir(path.dirname(args.outputPath));
-      const result = await ImageService.compressImage(args.inputPath, args.outputPath, {
-        quality: args.quality,
-        lossless: args.lossless,
-        effort: args.effort,
-        width: args.width,
-        height: args.height,
-        maxDimension: args.maxDimension,
-        recursiveCompress: args.recursiveCompress,
-        expectedSizeKB: args.expectedSizeKB,
-        qualityStepDown: args.qualityStepDown,
-        minimumQualityFloor: args.minimumQualityFloor,
-        outputFormat: args.outputFormat,
-      });
-
-      if (!result.success) {
-        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], isError: true };
-      }
-
-      return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
-      return { content: [{ type: 'text', text: `Failed to compress image: ${errorMessage}` }], isError: true };
-    }
-  }
-
-  static async handleCompressDirectory(args: CompressDirectoryArgs) {
-    const inputDir = path.resolve(args.inputDir);
-    const outputDir = path.resolve(args.outputDir);
-
-    const dirExists = await fs.pathExists(inputDir);
-    if (!dirExists) {
-      return { content: [{ type: 'text', text: `Input directory does not exist: ${inputDir}` }], isError: true };
-    }
-
-    await FileService.ensureDir(outputDir);
-
-    const outputFormat = args.outputFormat || DEFAULTS.outputFormat;
-    const quality = args.quality ?? DEFAULTS.quality;
-    const lossless = args.lossless ?? DEFAULTS.lossless;
-    const effort = args.effort ?? DEFAULTS.effort;
-    const maxDimension = args.maxDimension ?? DEFAULTS.maxDimension;
-    const recursiveCompress = args.recursiveCompress ?? false;
-    const expectedSizeKB = args.expectedSizeKB ?? DEFAULTS.expectedSizeKB;
-    const qualityStepDown = args.qualityStepDown ?? DEFAULTS.qualityStepDown;
-    const minimumQualityFloor = args.minimumQualityFloor ?? DEFAULTS.minimumQualityFloor;
-
-    const fileNaming: FileNamingOptions = {
-      enabled: args.normalizeFilename ?? false,
-      replaceChars: args.filenameReplaceChars
-        ? args.filenameReplaceChars.split(',').map(c => c.trim()).filter(c => c)
-        : DEFAULTS.filenameReplaceChars,
-      case: (args.filenameCase as 'lowercase' | 'uppercase' | 'original') || DEFAULTS.filenameCase,
-    };
-
-    const dirNaming: FileNamingOptions = {
-      enabled: args.normalizeDirname ?? false,
-      replaceChars: args.dirnameReplaceChars
-        ? args.dirnameReplaceChars.split(',').map(c => c.trim()).filter(c => c)
-        : DEFAULTS.dirnameReplaceChars,
-      case: (args.dirnameCase as 'lowercase' | 'uppercase' | 'original') || DEFAULTS.dirnameCase,
-    };
-
-    try {
-      const startTime = Date.now();
-      const allImageFiles = await FileService.getImageFiles(inputDir);
-      const toProcess: string[] = [];
-      const skipped: string[] = [];
-      for (const f of allImageFiles) {
-        if (path.extname(f).toLowerCase() === '.' + outputFormat) {
-          skipped.push(f);
-        } else {
-          toProcess.push(f);
-        }
-      }
-      const results: Awaited<ReturnType<typeof ImageService.compressImage>>[] = [];
-
-      for (const inputPath of toProcess) {
-        const outputPath = FileService.getOutputPath(inputPath, inputDir, outputDir, outputFormat, fileNaming, dirNaming);
-        await FileService.ensureDir(path.dirname(outputPath));
-
-        const result = await ImageService.compressImage(inputPath, outputPath, {
-          quality,
-          lossless,
-          effort,
-          maxDimension,
-          recursiveCompress,
-          expectedSizeKB,
-          qualityStepDown,
-          minimumQualityFloor,
-          outputFormat,
-        });
-
-        results.push(result);
-      }
-
-      const duration = Date.now() - startTime;
-      const reportPath = await ReportService.generateReport(results, inputDir, outputDir, outputFormat, startTime, duration, skipped);
-
-      const successful = results.filter(r => r.success).length;
-      const failed = results.length - successful;
-      const totalOriginal = results.reduce((s, r) => s + r.originalSize, 0);
-      const totalCompressed = results.reduce((s, r) => s + r.compressedSize, 0);
-      const overallReduction = totalOriginal > 0
-        ? parseFloat(((totalOriginal - totalCompressed) / totalOriginal * 100).toFixed(2))
-        : 0;
-
-      return {
-        content: [{
-          type: 'text',
-          text: JSON.stringify({
-            success: true,
-            totalFiles: results.length,
-            successful,
-            failed,
-            totalOriginalSize: totalOriginal,
-            totalCompressedSize: totalCompressed,
-            overallReduction,
-            durationMs: duration,
-            reportPath,
-          }, null, 2),
-        }],
-      };
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
-      return { content: [{ type: 'text', text: `Failed to process directory: ${errorMessage}` }], isError: true };
-    }
-  }
-
-  static handleGetAcknowledgement() {
-    const inputExtensions = SUPPORTED_EXTENSIONS.map(ext => ({
-      ext,
-      description: INPUT_EXTENSION_DESCRIPTIONS[ext] || 'Image format',
-    }));
-
-    const outputFormats = SUPPORTED_OUTPUT_FORMATS.map(format => ({
-      format,
-      description: OUTPUT_FORMAT_DESCRIPTIONS[format] || 'Output format',
-    }));
-
-    const tools = [
-      {
-        name: 'download_image',
-        description: 'Download an image from a URL to a specified path',
-        parameters: [
-          { name: 'url', type: 'string', required: true, description: 'URL of the image to download' },
-          { name: 'outputPath', type: 'string', required: true, description: 'Local path where to save the downloaded image' },
-        ],
-      },
-      {
-        name: 'compress_image',
-        description: 'Compress or convert a single image with format conversion, quality adjustment, resizing, and optional recursive compression',
-        parameters: [
-          { name: 'inputPath', type: 'string', required: true, description: 'Path to the input image' },
-          { name: 'outputPath', type: 'string', required: true, description: 'Path where to save the compressed image' },
-          { name: 'outputFormat', type: 'string', required: false, default: DEFAULTS.outputFormat, description: 'Output image format. Supported: ' + SUPPORTED_OUTPUT_FORMATS.join(', ') },
-          { name: 'quality', type: 'number', required: false, default: DEFAULTS.quality, description: 'Compression quality (1-100). Higher = better quality, larger file.' },
-          { name: 'lossless', type: 'boolean', required: false, default: DEFAULTS.lossless, description: 'Use lossless compression. Preserves all pixel data.' },
-          { name: 'effort', type: 'number', required: false, default: DEFAULTS.effort, description: 'CPU effort (0-6). Higher = better compression, slower.' },
-          { name: 'width', type: 'number', required: false, description: 'Exact target width in pixels. Aspect ratio maintained if only width specified.' },
-          { name: 'height', type: 'number', required: false, description: 'Exact target height in pixels. Aspect ratio maintained if only height specified.' },
-          { name: 'maxDimension', type: 'number', required: false, default: DEFAULTS.maxDimension, description: 'Auto-resize if width or height exceeds this pixel threshold.' },
-          { name: 'recursiveCompress', type: 'boolean', required: false, default: false, description: 'Re-compress until file size is under expectedSizeKB.' },
-          { name: 'expectedSizeKB', type: 'number', required: false, default: DEFAULTS.expectedSizeKB, description: 'Target file size in KB for recursive compression.' },
-          { name: 'qualityStepDown', type: 'number', required: false, default: DEFAULTS.qualityStepDown, description: 'Quality reduction per recursive iteration.' },
-          { name: 'minimumQualityFloor', type: 'number', required: false, default: DEFAULTS.minimumQualityFloor, description: 'Minimum quality allowed during recursive compression.' },
-        ],
-      },
-      {
-        name: 'compress_directory',
-        description: 'Batch compress all images in a directory recursively, preserving folder structure, with auto-generated report',
-        parameters: [
-          { name: 'inputDir', type: 'string', required: true, description: 'Input directory containing images to compress' },
-          { name: 'outputDir', type: 'string', required: true, description: 'Output directory where compressed images will be saved' },
-          { name: 'outputFormat', type: 'string', required: false, default: DEFAULTS.outputFormat, description: 'Output image format. Supported: ' + SUPPORTED_OUTPUT_FORMATS.join(', ') },
-          { name: 'quality', type: 'number', required: false, default: DEFAULTS.quality, description: 'Compression quality (1-100)' },
-          { name: 'lossless', type: 'boolean', required: false, default: DEFAULTS.lossless, description: 'Use lossless compression' },
-          { name: 'effort', type: 'number', required: false, default: DEFAULTS.effort, description: 'CPU effort (0-6)' },
-          { name: 'maxDimension', type: 'number', required: false, default: DEFAULTS.maxDimension, description: 'Auto-resize threshold in pixels' },
-          { name: 'normalizeFilename', type: 'boolean', required: false, default: false, description: 'Enable filename normalization (replace chars, apply case)' },
-          { name: 'filenameReplaceChars', type: 'string', required: false, description: 'Characters to replace with underscore, comma-separated' },
-          { name: 'filenameCase', type: 'string', required: false, default: DEFAULTS.filenameCase, description: 'Filename case: lowercase, uppercase, or original' },
-          { name: 'normalizeDirname', type: 'boolean', required: false, default: false, description: 'Enable directory name normalization' },
-          { name: 'dirnameReplaceChars', type: 'string', required: false, description: 'Characters to replace in directory names, comma-separated' },
-          { name: 'dirnameCase', type: 'string', required: false, default: DEFAULTS.dirnameCase, description: 'Directory name case: lowercase, uppercase, or original' },
-          { name: 'recursiveCompress', type: 'boolean', required: false, default: false, description: 'Re-compress oversized outputs until target size' },
-          { name: 'expectedSizeKB', type: 'number', required: false, default: DEFAULTS.expectedSizeKB, description: 'Target file size in KB' },
-          { name: 'qualityStepDown', type: 'number', required: false, default: DEFAULTS.qualityStepDown, description: 'Quality decrease per iteration' },
-          { name: 'minimumQualityFloor', type: 'number', required: false, default: DEFAULTS.minimumQualityFloor, description: 'Minimum quality floor' },
-        ],
-      },
-      {
-        name: 'get_acknowledgement',
-        description: 'Get all configuration defaults, supported formats, and detailed tool descriptions. Use this tool to understand the full capabilities of this MCP server.',
-        parameters: [],
-      },
-    ];
-
-    return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify({
-          app: { name: APP_CONFIG.name, version: APP_CONFIG.version },
-          configDefaults: CONFIG_DESCRIPTIONS,
-          supportedInputExtensions: inputExtensions,
-          supportedOutputFormats: outputFormats,
-          tools,
-        }, null, 2),
-      }],
-    };
-  }
-}