Image Worker MCP

🚀 @boomlinkai/image-worker-mcp

このサーバーは、AIアシスタントや自動化ワークフローに最適化された、高速で即座に利用できる画像処理とクラウドアップロード用の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サーバーはstdioを介して動作するため、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は自動的にインストールされます。

🐞 トラブルシューティング / FAQ

• ARM/Apple Siliconでのインストールが失敗する場合：brew install vips（sharpの依存関係）を実行するか、Node 18+を使用してください。
• 資格情報が機能しない場合：環境変数のスペルと大文字小文字を確認してください。
• 画像出力が空白または破損している場合：入力画像のタイプとサイズを確認してください。

🤝 コントリビューション

PRとイシューを歓迎します！ イシューを開く またはプルリクエストを送信してください。

👤 作者

Vuong Ngo – BoomLink.ai

🌐 私たちとつながる

• Discordに参加する サポート、フィードバック、コミュニティディスカッションのため
• X.comでフォローする アップデートとニュースのため
• LinkedInでつながる 会社のニュースと洞察のため

📄 ライセンス

MIT

💖 スポンサー: BoomLink.ai