Image Worker MCP

[](https://mseep.ai/app/boomlinkai-image-worker-mcp) # @boomlinkai/image-worker-mcp  A fast, plug-and-play MCP server for **image processing** and **cloud uploads**, designed for AI assistants and automation workflows. --- ## 📝 What is @boomlinkai/image-worker-mcp? A lightweight server implementing [Model Context Protocol (MCP)](https://github.com/modelcontextprotocol) for automated image manipulation and uploads. It makes image resizing, converting, optimizing, and uploading seamless for devs, AI tools, or automated pipelines. --- ## ✨ Features - **All-in-One Image Processing:** Resize, convert, optimize, and transform images with the powerful [sharp](https://sharp.pixelplumbing.com/) library. - **Effortless Cloud Uploads:** Integrates with AWS S3, Cloudflare R2, Google Cloud Storage. - **AI & Workflow Ready:** Built for MCP, integrates with any AI assistant or workflow runner. - **Flexible Input:** Works with file paths, URLs, or base64 images. - **Automatable:** Scriptable for batch tasks or as a backend service. --- ## 🚀 How to Install Use **npm** (or yarn/pnpm): ```sh npm install -g @boomlinkai/image-worker-mcp # or yarn global add @boomlinkai/image-worker-mcp # or pnpm add -g @boomlinkai/image-worker-mcp ```` Or use it instantly (no install): ```sh npx @boomlinkai/image-worker-mcp ``` --- ## ⚡ Quick Start ### Start the MCP Server ```sh npx @boomlinkai/image-worker-mcp ``` ### Example: AI Assistant Workflow Resize an image: ```json { "tool_code": "use_mcp_tool", "tool_name": "resize_image", "server_name": "image-worker", "arguments": { "imageUrl": "https://example.com/original.jpg", "width": 800, "format": "webp", "outputPath": "./resized_image.webp" } } ``` Upload an image: ```json { "tool_code": "use_mcp_tool", "tool_name": "upload_image", "server_name": "image-worker", "arguments": { "imagePath": "./resized_image.webp", "service": "s3", "filename": "my-optimized-image", "folder": "website-assets" } } ``` --- ## 🛠️ Usage & Configuration The MCP server works via **stdio**, making it easy to plug into AI tools and code editors. ### Platform Integrations <details> <summary>Click to expand platform setup guides (Cursor, Windsurf, VSCode, Zed, Claude, BoltAI, Roo Code)</summary> #### Cursor Add to `~/.cursor/mcp.json`: ```json { "mcpServers": { "image-worker": { "command": "npx", "args": ["-y", "@boomlinkai/image-worker-mcp"] } } } ``` <!-- Repeat for other platforms as in your original --> </details> --- ## 🧰 Tools Reference ### `resize_image` Resize and transform images via: * `imagePath`, `imageUrl`, or `base64Image` (input) * `width`, `height`, `fit`, `format`, `quality`, `rotate`, etc. * Returns path or base64 of processed image ### `upload_image` Upload any image (by path/url/base64) to: * `service`: `s3` | `cloudflare` | `gcloud` * `filename`, `folder`, `public`, etc. * Set credentials as env vars --- ## 🔑 Environment Variables Set these for your chosen cloud provider: **AWS S3** ```sh export AWS_ACCESS_KEY_ID=xxx export AWS_SECRET_ACCESS_KEY=xxx export S3_BUCKET=your-bucket export S3_REGION=us-east-1 # Optional: S3_ENDPOINT=https://... ``` **Cloudflare R2** ```sh export CLOUDFLARE_R2_ACCESS_KEY_ID=xxx export CLOUDFLARE_R2_SECRET_ACCESS_KEY=xxx export CLOUDFLARE_R2_BUCKET=your-bucket export CLOUDFLARE_R2_ENDPOINT=https://... ``` **Google Cloud Storage** ```sh export GCLOUD_PROJECT_ID=xxx export GCLOUD_BUCKET=your-bucket # Optionally: GCLOUD_CREDENTIALS_PATH=/path/to/key.json ``` **Default upload service:** ```sh export UPLOAD_SERVICE=s3 ``` > ⚠️ **Never commit credentials to source control.** Use environment variables or secret managers. --- ## 🏗️ Requirements * Node.js 18.x or higher * No system dependencies; `sharp` is auto-installed --- ## 🐞 Troubleshooting / FAQ * **Install fails on ARM/Apple Silicon?** Run `brew install vips` (sharp dependency) or use Node 18+. * **Credentials not working?** Check env var spelling/casing. * **Image output is blank or corrupt?** Confirm input image type and size. --- ## 🤝 Contributing PRs and issues welcome! Please [open an issue](https://github.com/BoomLinkAi/image-worker-mcp/issues) or submit a pull request. --- ## 👤 Author **Vuong Ngo** – [BoomLink.ai](https://boomlink.ai) --- ## 🌐 Connect with Us [](https://discord.gg/88ND8bpmrA) [](https://x.com/agimon_ai) [](https://linkedin.com/company/boomlink) - **[Join our Discord](https://discord.gg/88ND8bpmrA)** for support, feedback, and community discussions - **[Follow us on X.com](https://x.com/agimon_ai)** for updates and news - **[Connect on LinkedIn](https://linkedin.com/company/boomlink)** for company news and insights --- ## 📄 License MIT --- ## 💖 Sponsored by BoomLink.ai [](https://boomlink.ai)