# ImgBB MCP Server 🖼️

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

## 📋 简介

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

**核心特性：**
- ✅ **完全免费** - 无需注册、无需 API Key
- ✅ **匿名上传** - 保护隐私，无需登录
- ✅ **支持本地文件** - 直接上传本地图片
- ✅ **支持网络图片** - 传入 URL 即可转存
- ✅ **返回丰富信息** - 图片链接、缩略图、删除链接等
- ✅ **MCP 标准协议** - 兼容所有 MCP 客户端

## 🚀 快速开始

### 1. 安装依赖

```bash
pip install mcp
```

### 2. 运行 MCP Server

```bash
python3 mcp_server.py
```

### 3. 配置 MCP 客户端

#### Claude Desktop

编辑 `claude_desktop_config.json`：

```json
{
  "mcpServers": {
    "imgbb": {
      "command": "python3",
      "args": ["/path/to/imgbb-mcp/mcp_server.py"]
    }
  }
}
```

#### Cursor

在 Cursor 的 MCP 配置中添加：

```json
{
  "mcpServers": {
    "imgbb": {
      "command": "python3",
      "args": ["/path/to/imgbb-mcp/mcp_server.py"]
    }
  }
}
```

## 🛠️ 可用工具

### 1. `upload_image`

上传图片到 ImgBB 图床（支持本地文件和网络 URL）

**参数：**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `source` | string | ✅ | 本地文件路径 或 网络图片 URL |

**返回示例：**

```json
{
  "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）

也可以直接使用上传脚本：

```bash
# 上传本地图片
python3 imgbb_upload.py /path/to/image.png

# 上传网络图片
python3 imgbb_upload.py https://example.com/photo.jpg
```

## ⚠️ 注意事项

- ImgBB 是免费图床，请勿上传违规内容
- 单张图片最大支持 **32MB**
- 上传的图片默认 **永久保存**，除非手动删除
- 删除链接请妥善保存，删除后不可恢复

## ⚖️ 免责声明

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

1. **遵守服务条款** — ImgBB 的服务条款禁止商业用途和自动化访问，使用者应自行阅读并遵守 [ImgBB ToS](https://imgbb.com/tos)
2. **责任自负** — 使用本工具产生的一切后果由使用者自行承担，项目作者不承担任何法律责任
3. **非官方关联** — 本项目与 ImgBB 无任何关联，未获 ImgBB 认可或授权
4. **商业场景** — 如需商业用途，请选择合规的图床服务（如 Cloudinary、阿里云 OSS、AWS S3 等）
5. **合规内容** — 请勿上传侵权、违法或违规内容

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

## 📄 许可证

MIT