Image Worker MCP

🚀 @boomlinkai/image-worker-mcp

這是一個快速、即插即用的MCP服務器，專為AI助手和自動化工作流設計，可用於圖像處理和雲上傳。它能幫助開發者輕鬆實現圖像的處理和上傳，大大提升工作效率。

🚀 快速開始

啟動MCP服務器

npx @boomlinkai/image-worker-mcp

示例：AI助手工作流

調整圖像大小

{
  "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"
  }
}

上傳圖像

{
  "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"
  }
}

✨ 主要特性

• 一體化圖像處理：藉助強大的 sharp 庫，可實現圖像的調整大小、轉換格式、優化和變換。
• 輕鬆實現雲上傳：支持與AWS S3、Cloudflare R2、Google Cloud Storage集成。
• 適配AI與工作流：基於MCP構建，可與任何AI助手或工作流運行器集成。
• 靈活的輸入方式：支持文件路徑、URL或base64編碼的圖像。
• 可自動化操作：可編寫腳本進行批量任務處理，或作為後端服務使用。

📦 安裝指南

使用npm（或yarn/pnpm）安裝

npm install -g @boomlinkai/image-worker-mcp
# 或者
yarn global add @boomlinkai/image-worker-mcp
# 或者
pnpm add -g @boomlinkai/image-worker-mcp

直接使用（無需安裝）

npx @boomlinkai/image-worker-mcp

📚 詳細文檔

使用與配置

MCP服務器通過標準輸入輸出工作，便於集成到AI工具和代碼編輯器中。

平臺集成

{
  "mcpServers": {
    "image-worker": {
      "command": "npx",
      "args": ["-y", "@boomlinkai/image-worker-mcp"]
    }
  }
}

工具參考

resize_image

可通過以下方式調整和變換圖像：

• imagePath、imageUrl 或 base64Image（輸入）
• width、height、fit、format、quality、rotate 等參數
• 返回處理後圖像的路徑或base64編碼

upload_image

可將任何圖像（通過路徑/URL/base64編碼）上傳到：

• service：s3 | cloudflare | gcloud
• 可設置 filename、folder、public 等參數
• 通過環境變量設置憑證

環境變量

為你選擇的雲提供商設置以下環境變量：

AWS S3

export AWS_ACCESS_KEY_ID=xxx
export AWS_SECRET_ACCESS_KEY=xxx
export S3_BUCKET=your-bucket
export S3_REGION=us-east-1
# 可選：S3_ENDPOINT=https://...

Cloudflare R2

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

export GCLOUD_PROJECT_ID=xxx
export GCLOUD_BUCKET=your-bucket
# 可選：GCLOUD_CREDENTIALS_PATH=/path/to/key.json

默認上傳服務

export UPLOAD_SERVICE=s3

⚠️ 重要提示

切勿將憑證提交到源代碼管理中。請使用環境變量或密鑰管理器。

要求

• Node.js 18.x 或更高版本
• 無需系統依賴；sharp 會自動安裝

故障排除/常見問題解答

• 在ARM/Apple Silicon上安裝失敗？ 運行 brew install vips（sharp依賴項）或使用Node 18+。
• 憑證無法使用？ 檢查環境變量的拼寫和大小寫。
• 圖像輸出為空或損壞？ 確認輸入圖像的類型和大小。

🤝 貢獻

歡迎提交PR和提出問題！請 創建一個問題 或提交拉取請求。

👤 作者

Vuong Ngo – BoomLink.ai

🌐 與我們聯繫

• 加入我們的Discord 獲取支持、反饋和社區討論
• 在X.com上關注我們 獲取更新和新聞
• 在LinkedIn上聯繫我們 獲取公司新聞和見解

📄 許可證

MIT

💖 由BoomLink.ai贊助