@boomlinkai/image-worker-mcp

一个快速、即插即用的MCP服务器，用于图像处理和云上传，专为AI助手和自动化工作流设计。

---

📝 @boomlinkai/image-worker-mcp 是什么？

这是一个轻量级服务器，实现了模型上下文协议（MCP），用于自动化的图像操作和上传。它使图像调整大小、转换、优化和上传对开发者、AI工具或自动化流水线无缝进行。

---

✨ 特性

• 全方位图像处理： 使用强大的 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 服务器

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

---

🛠️ 使用与配置

MCP 服务器通过 stdio 运作，使其易于集成到 AI 工具和代码编辑器中。

平台集成

<details> <summary>点击展开平台设置指南（Cursor、Windsurf、VSCode、Zed、Claude、BoltAI、Roo Code）</summary>

Cursor

添加到 ~/.cursor/mcp.json：

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

<!-- 其他平台重复此处 --> </details>

---

🧰 工具参考

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 赞助