ImgBB MCP Server 🖼️
免费图床 MCP 服务 - 将图片上传到 ImgBB 并获取公网链接
📋 简介
这是一个基于 MCP (Model Context Protocol) 的免费图床服务，将 ImgBB 匿名上传功能封装为 MCP 工具，供 AI 客户端（如 Claude Desktop、Cursor 等）直接调用。
核心特性：
- ✅ 完全免费 - 无需注册、无需 API Key
- ✅ 匿名上传 - 保护隐私，无需登录
- ✅ 支持本地文件 - 直接上传本地图片
- ✅ 支持网络图片 - 传入 URL 即可转存
- ✅ 返回丰富信息 - 图片链接、缩略图、删除链接等
- ✅ MCP 标准协议 - 兼容所有 MCP 客户端
🚀 快速开始
1. 安装依赖
pip install mcp2. 运行 MCP Server
python3 mcp_server.py3. 配置 MCP 客户端
Claude Desktop
编辑 claude_desktop_config.json：
{
"mcpServers": {
"imgbb": {
"command": "python3",
"args": ["/path/to/imgbb-mcp/mcp_server.py"]
}
}
}Cursor
在 Cursor 的 MCP 配置中添加：
{
"mcpServers": {
"imgbb": {
"command": "python3",
"args": ["/path/to/imgbb-mcp/mcp_server.py"]
}
}
}🛠️ 可用工具
1. upload_image
上传图片到 ImgBB 图床（支持本地文件和网络 URL）
参数：
| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | source | string | ✅ | 本地文件路径 或 网络图片 URL |
返回示例：
{
"success": true,
"url": "https://i.ibb.co/xxxxx/image.png",
"url_viewer": "https://ibb.co/xxxxx",
"delete_url": "https://ibb.co/delete/xxxxx",
"display_url": "https://i.ibb.co/xxxxx/image.png",
"filename": "image.png",
"width": 1920,
"height": 1080,
"size": 123456,
"size_formatted": "120 KB",
"thumb_url": "https://i.ibb.co/xxxxx/thumb-image.png"
}2. upload_image_from_url
专门从网络 URL 上传图片
参数：
| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | url | string | ✅ | 网络图片的完整 URL 地址 |
📦 项目结构
imgbb-mcp/
├── mcp_server.py # MCP Server 主程序
├── imgbb_upload.py # 独立上传脚本（可直接命令行使用）
├── requirements.txt # Python 依赖
├── pyproject.toml # 项目配置
├── package.json # MCP 配置（兼容格式）
└── README.md # 本文件🔧 独立使用（无需 MCP）
也可以直接使用上传脚本：
# 上传本地图片
python3 imgbb_upload.py /path/to/image.png
# 上传网络图片
python3 imgbb_upload.py https://example.com/photo.jpg⚠️ 注意事项
- ImgBB 是免费图床，请勿上传违规内容
- 单张图片最大支持 32MB
- 上传的图片默认 永久保存，除非手动删除
- 删除链接请妥善保存，删除后不可恢复
⚖️ 免责声明
本工具仅供学习和个人参考使用，使用者应自行注意以下事项：
- 遵守服务条款 — ImgBB 的服务条款禁止商业用途和自动化访问，使用者应自行阅读并遵守 ImgBB ToS
- 责任自负 — 使用本工具产生的一切后果由使用者自行承担，项目作者不承担任何法律责任
- 非官方关联 — 本项目与 ImgBB 无任何关联，未获 ImgBB 认可或授权
- 商业场景 — 如需商业用途，请选择合规的图床服务（如 Cloudinary、阿里云 OSS、AWS S3 等）
- 合规内容 — 请勿上传侵权、违法或违规内容
📌 工具中立原则：本项目是纯粹的技术实现，如同浏览器或下载工具一样，使用者如何使用完全取决于使用者自身。
📄 许可证
MIT
