image-process

The Image Process MCP Server exposes a set of image manipulation tools built on the Sharp library. It supports resizing images, converting between common formats (jpeg, png, webp, avif, tiff, gif), cropping regions, rotating images, and retrieving basic image metadata. You can invoke these tools through the MCP protocol, sending the appropriate method name and parameter object to process images in your workflows or automation pipelines. The server is designed to work with the Model Context Protocol SDK and can be run via npx as shown in the examples.

To use the tools, start the server using the provided MCP configuration, and call the available tool methods such as resizeImage, convertFormat, cropImage, rotateImage, and getImageInfo. Each tool accepts a JSON payload with input_path and output_path, plus the relevant parameters (dimensions, format, crop coordinates, rotation angle, etc.). The server supports bilingual documentation (English and Chinese) for tool parameters, ensuring accessibility for multilingual teams.

Prerequisites:\n- Node.js (recommended LTS) installed on your system.\n- npm or npx available in your environment.\n- Access to the internet to fetch the image-process-mcp-server package.\n\nInstallation steps:\n1) Verify Node.js and npm versions:\n - node -v\n - npm -v\n\n2) Install and run the MCP server using npx (no permanent installation required):\n - npx -y image-process-mcp-server\n\n3) If you prefer to install the package locally, run:\n - npm install image-process-mcp-server\n - npx -y image-process-mcp-server\n\n4) Ensure dependencies such as sharp are available in your environment. The server relies on sharp for image processing.\n\n5) (Optional) If your environment uses a package manager other than npm, adapt the command to your workflow while maintaining the same configuration.\n\nNotes:\n- The MCP server assumes Node.js and npm are present.\n- If you encounter native module build issues with sharp, make sure your system has the required build tools (python2 or python3, gcc/clang, make) and libraries installed.\n- The provided examples use the recommended npm package name image-process-mcp-server for npx invocation.

Tips and common issues:\n- Ensure input_path and output_path are accessible by the server process, with appropriate read/write permissions.\n- For convertFormat, some formats support quality settings (1-100); adjust as needed for file size and fidelity.\n- When resizing, consider the fit option (cover, contain, fill, inside, outside) to control aspect ratio behavior.\n- If using Windows, follow the Windows-specific invocation in the README (cmd /c npx -y image-process-mcp-server).\n- The MCP server bundles the Sharp library; ensure libvips and native dependencies are compatible with your OS.\n- If you update the server package, re-run the installation step to sync dependencies.\n- Environment variables can be added to the mcpServers entry if the server requires API keys or configuration flags.