Skip to content

About

MCP server to convert images to webp or avif using SHARP library

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

MCP-GDX-Image-Webify

Node.js npm TypeScript Sharp Modelcontextprotocol

Coverage

Description

MCP-GDX-Image-Webify is an MCP Server (Stdio) based on Node.js and typescript, that allows you to convert images into the WebP or AVIF formats using the sharp library. It supports multiple image formats such as JPG, JPEG, PNG, WebP, TIFF, AVIF, GIF, and SVG. The tool allows you to specify the quality of the conversion and the output directory for the converted images. On result it shows original size, new size and saving.

Installation

Prerequisites

Node.js NPM

Install

  1. Clone the repository:
git clone https://github.com/geckod22/MCP-GDX-Image-Webify.git
cd MCP-GDX-Image-Webify
  1. Install deps
npm install
  1. Build
npm run build

MCP Client configuration

Automatic

Just run:

npm run installToClients

then follow the steps.

At the moment the script supports the following clients: Claude Desktop, Gemini Cli, Visual Code

Manual General config:
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "node",
      "args": ["your_path\\MCP-GDX-Image-Webify\\build\\index.js"]
    }
  }
}
Claude Desktop Follow the guide and use the standard config from above.
Copilot / VS Code

Follow the MCP install guide, and use the above general config.

Cursor

Click the button to install:

Go to Cursor Settings -> MCP -> New MCP Server. Use the General config above.

Gemini CLI

Follow the MCP guide and use the standard config from above.

Windsurf Follow the configure MCP guide using the standard config from above.

Your first prompt

Ex of usage. Open your project folder and run gemini cli, then Enter the following prompt to check if everything is working:

Convert the images in the current project images folder to webp with quality 80.

Testing

Run the Inspector:

npx @modelcontextprotocol/inspector node build/index.js

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests to improve the project.

License

This project is licensed under the MIT License.

Credits

This project uses Sharp for high-performance image processing, licensed under the Apache License 2.0.

About

MCP server to convert images to webp or avif using SHARP library

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages