Skip to main content
Glama
450689994

ImgBB MCP Server

by 450689994

ImgBB MCP Server 🖼️

免费图床 MCP 服务 - 将图片上传到 ImgBB 并获取公网链接

📋 简介

这是一个基于 MCP (Model Context Protocol) 的免费图床服务,将 ImgBB 匿名上传功能封装为 MCP 工具,供 AI 客户端(如 Claude Desktop、Cursor 等)直接调用。

核心特性:

  • 完全免费 - 无需注册、无需 API Key

  • 匿名上传 - 保护隐私,无需登录

  • 支持本地文件 - 直接上传本地图片

  • 支持网络图片 - 传入 URL 即可转存

  • 返回丰富信息 - 图片链接、缩略图、删除链接等

  • MCP 标准协议 - 兼容所有 MCP 客户端

Related MCP server: MCP Nano Banana

🚀 快速开始

1. 安装依赖

pip install mcp

2. 运行 MCP Server

python3 mcp_server.py

3. 配置 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

  • 上传的图片默认 永久保存,除非手动删除

  • 删除链接请妥善保存,删除后不可恢复

⚖️ 免责声明

本工具仅供学习和个人参考使用,使用者应自行注意以下事项:

  1. 遵守服务条款 — ImgBB 的服务条款禁止商业用途和自动化访问,使用者应自行阅读并遵守 ImgBB ToS

  2. 责任自负 — 使用本工具产生的一切后果由使用者自行承担,项目作者不承担任何法律责任

  3. 非官方关联 — 本项目与 ImgBB 无任何关联,未获 ImgBB 认可或授权

  4. 商业场景 — 如需商业用途,请选择合规的图床服务(如 Cloudinary、阿里云 OSS、AWS S3 等)

  5. 合规内容 — 请勿上传侵权、违法或违规内容

📌 工具中立原则:本项目是纯粹的技术实现,如同浏览器或下载工具一样,使用者如何使用完全取决于使用者自身。

📄 许可证

MIT

Related MCP Connectors

Related MCP Servers