使用说明
@博林凯/图像工作者mcp
一个快速、即插即用的MCP服务器 图像处理 和 云上传，专为人工智能助手和自动化工作流程而设计。
📝 什么是@boomlinkai/image worker mcp？
轻量级服务器实现 模型上下文协议（MCP） 用于自动图像处理和上传。它使开发人员、人工智能工具或自动化管道能够无缝调整图像大小、转换、优化和上传。
✨ 特性
- 多功能图像处理： 使用强大的 锋利 图书馆。
- 轻松的云上传： 与AWS S3、Cloudflare R2、谷歌云存储集成。
- AI和工作流就绪： 专为MCP构建，可与任何AI助手或工作流运行器集成。
- 灵活输入： 适用于文件路径、URL或base64图像。
- 可自动化： 可编写脚本用于批处理任务或作为后端服务。
🚀 如何安装
使用 npm （或纱线/pnpm）：
npm install -g @boomlinkai/image-worker-mcp
# or
yarn global add @boomlinkai/image-worker-mcp
# or
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服务器通过以下方式工作 标准，使其易于插入人工智能工具和代码编辑器。
平台集成
Click to expand platform setup guides (Cursor, Windsurf, VSCode, Zed, Claude, BoltAI, Roo Code)
光标
增添 ~/.cursor/mcp.json:
{
"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/b64）上传到：
service:s3|cloudflare|gcloudfilename,folder,public等等。- 将凭据设置为env变量
🔑 环境变量
为您选择的云提供商设置以下内容：
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
# Optional: 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://...
谷歌云存储
export GCLOUD_PROJECT_ID=xxx
export GCLOUD_BUCKET=your-bucket
# Optionally: GCLOUD_CREDENTIALS_PATH=/path/to/key.json
默认上传服务：
export UPLOAD_SERVICE=s3
⚠️ 切勿将凭据提交到源代码管理。 使用环境变量或秘密管理器。
🏗️ 需求
- Node.js 18.x或更高版本
- 无系统依赖性；
sharp已自动安装
🐞 故障排除/常见问题
- ARM/Apple Silicon上的安装失败？ 跑
brew install vips（严重依赖）或使用Node 18+。 - 凭据不起作用？ 检查env变量拼写/大小写。
- 图像输出为空白或损坏？ 确认输入图像类型和大小。
🤝 贡献
欢迎PR和问题！请 打开一个问题 或者提交拉取请求。
👤 作者
吴恩戈 – BoomLink.ai
🌐 联系我们
- 加入我们的Discord 用于支持、反馈和社区讨论
- 在X.com上关注我们 获取更新和新闻
- 在LinkedIn上连接 获取公司新闻和见解
📄 许可证
麻省理工学院
