Image Tools MCP

🚀 Image Tools MCP Service

The Image Tools MCP (Model Context Protocol) service is a powerful image processing tool that offers a range of operations to handle images effectively.

🚀 Quick Start

This tool can be used via the command line or integrated into other systems. Below are the main interface specifications:

Get Remote Image Dimensions

{
  options: {
    imageUrl: string // URL address of the image for which dimensions need to be obtained
  }
}

Get Local Image Dimensions

{
  options: {
    imagePath: string; // Local image file with an absolute path
  }
}

Compress Remote Image

{
  options: {
    imageUrl: string // URL address of the image to be compressed
    outputFormat?: "image/webp" | "image/jpeg" | "image/jpg" | "image/png" // Optional output format
  }
}

Compress Local Image

{
  options: {
    imagePath: string // Local image file with an absolute path
    outputPath?: string // Optional target output path
    outputFormat?: "image/webp" | "image/jpeg" | "image/jpg" | "image/png" // Optional output format
  }
}

Figma File Processing

{
  options: {
    figmaUrl: string; // Link to the Figma file to be parsed
  }
}

Environment Configuration

To ensure all functions work properly, it is recommended to set the following environment variables:

• TINIFY_API_KEY: Used to call the TinyPNG API. Obtain it from TinyPNG Developers Page.
• FIGMA_API_TOKEN: Used to interact with the Figma API. Refer to Figma Developer Documentation for the acquisition method.

Note: The basic function (getting dimension information) can be used without the above environment variables.

✨ Features

Get Image Dimensions

• Supports getting the width and height of remote images via URL.
• Supports reading the actual dimensions of local image files.

Compression and Optimization

• Uses the TinyPNG API for online compression.
• Significantly reduces file size while maintaining the original image quality.

Format Conversion

• Supports converting images from one format to another.
• Common formats include WebP, JPEG, JPG, and PNG.

Figma Integration

• Parses all image resources in Figma files.
• Provides a complete list of image links.

💻 Usage Examples

Basic Usage

{
  options: {
    imageUrl: "https://example.com/image.jpg"
  }
}

Advanced Usage

{
  options: {
    imagePath: "/path/to/local/image.png",
    outputPath: "/path/to/output/image.webp",
    outputFormat: "image/webp"
  }
}

🔧 Technical Details

This project is built on the following excellent open - source libraries:

• probe-image-size: Used to quickly obtain image dimensions.
• tinify: Provides support for the TinyPNG API.
• figma-api: Implements the parsing of Figma files.

📄 License

This project follows the MIT open - source license. You are welcome to use and modify it freely.