Desktop Image Manager MCP

🚀 Desktop Image Management MCP Server

A desktop image management server developed based on Model Context Protocol (MCP), offering functions for image file statistics, viewing, and compression.

🚀 Quick Start

Operation Example

https://claude.ai/share/0ffbad1e-502e-4188-b008-0bb966acf06d

✨ Features

• Image Counting: Quickly obtain the total number of image files on the desktop.
• Image Listing: List the names of all image files on the desktop.
• Image Compression: Support compression of image files in formats such as JPG, PNG, and WebP, with customizable compression quality.

🔧 Technical Details

Let Trae refer to ./demand.md for functional code generation. The simplified version is as follows:

... (Here is the already introduced domain knowledge)

Build an MCP server that can:
- Functions:
  - Count the number of image files on the current desktop.
  - Get the names of the corresponding files.
  - Support image compression.

Requirements:
- Do not provide prompt and resource-related code.
- You can assume that my desktop path is /Users/{username}/Desktop

📋 Supported Image Formats

• JPG/JPEG
• PNG
• GIF
• BMP
• WebP
• TIFF
• SVG

📦 Installation

Environment Requirements

• Node.js >= 16
• pnpm >= 8

Installation Steps

# Clone the project
git clone <repository-url>
cd desktop-image-manager

# Install dependencies
pnpm install

💻 Usage Examples

Development

# Start the development server
pnpm dev

Build and Run

# Build the project
pnpm build

# Run the server
pnpm start

Debugging

# Debug the MCP service
pnpm inspector

Usage Instructions

1. Counting Image Files

• Function: Count the total number of image files on the desktop.
• Steps:
  1. Start the server.
  2. Use the API to request the number of images.

2. Listing Image Files

• Function: List the names of all image files on the desktop.
• Steps:
  1. Start the server.
  2. Use the API to request the list of images.

3. Image Compression

• Function: Support compression of image files in formats such as JPG, PNG, and WebP, with customizable compression quality.
• Steps:
  1. Start the server.
  2. Upload the image files to be compressed.
  3. Set the compression parameters (e.g., target format, compression quality).
  4. Use the API to request compression and download the result.

📄 Important Notes

⚠️ Important Note

Ensure that the server runtime environment meets the minimum requirements: Node.js >= 16 and pnpm >= 8.

💡 Usage Tip

When using the image compression function, it is recommended to test different parameter combinations to achieve the best results. Keep the code repository clean and regularly clean up unnecessary dependencies and files.