Desktop Image Manager

Provides image counting, listing, and compression capabilities for desktop images via MCP.

typescript

4

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "zhixiaoqiang-desktop-image-manager-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@jzone-mcp/desktop-image-manager-mcp"
      ],
      "env": {
        "DESKTOP_PATH": "/Users/yourname/Desktop"
      }
    }
  }
}

This MCP server lets you manage desktop images by counting, listing, and compressing image files on your computer using the Model Context Protocol. It provides practical automation for quick insights and space optimization of your desktop image collection.

How to use

You interact with this MCP server through an MCP client to perform three core actions: count how many images exist on your desktop, retrieve the list of image file names, and compress selected images with adjustable quality. Use the tools provided by your MCP client to call these functions in sequence or individually, depending on your workflow.

Common usage patterns include: counting desktop images before deciding what to back up, listing images to pick specific files for compression, and running image compression to reclaim disk space without losing essential visuals. You can trigger these actions from your MCP client without writing your own integration if you rely on the prebuilt tools described below.

How to install

Prerequisites you need installed on your system before you start:

Node.js >= 16
pnpm >= 8

Then follow these concrete steps to set up and run the MCP server locally.

# Install or clone the MCP server package
# The following install/configure command is provided for local setup through your MCP client ecosystem
# Replace with the actual project origin if you are pulling from a local source

# Install dependencies for the MCP server package
pnpm install

# Start the development or runtime server as defined by your environment
pnpm dev

Additional configuration and run notes

The project supports running via a standard MCP runtime configuration. A ready-to-use deployment snippet is provided for CLI tooling integration that uses npx to invoke the MCP package.

{
  "desktop-image-manager": {
      "command": "npx",
      "args": [
        "-y",
        "@jzone-mcp/desktop-image-manager-mcp"
      ]
    }
}

Supported image formats

The server supports the following image formats: JPG/JPEG, PNG, GIF, BMP, WebP, TIFF, SVG.

Available tools

count-desktop-images

Count the number of image files on the desktop using supported image formats.

list-desktop-images

Retrieve the list of image file names currently present on the desktop.

compress-image

Compress a specified image file with adjustable quality and optional output filename.