# 豆包图片描述 MCP 服务器

> 让 iFlow CLI 和 Claude Desktop 支持豆包视觉理解

## 🚀 快速开始（3 步）

### 1. 安装依赖
```bash
pip install -r requirements.txt
```

### 2. 配置 API Key

**方式 1：环境变量（推荐）**
```bash
# Windows
set VOLCENGINE_API_KEY=你的豆包API Key

# Linux/Mac
export VOLCENGINE_API_KEY=你的API Key
```

**方式 2：配置文件**
```bash
cp config.example.json config.json
# 编辑 config.json，填入你的 API Key
```

### 3. 添加到 iFlow CLI
```bash
iflow mcp add doubao-image-mcp python C:\Users\15579\doubao-image-mcp\server.py
```

### 4. 测试
```bash
iflow
> 描述: https://picsum.photos/800/600
```

## 📖 完整文档

- **INSTALL_GUIDE.md** - 详细安装和配置指南
- **论坛帖子.md** - 完整的开发历程和技术细节

## ✨ 特性

- ⚡ **快速**：20-30 秒响应
- 💾 **缓存**：重复查询 < 0.1 秒
- 🖼️ **18 种格式**：JPG、PNG、GIF、WEBP、HEIC 等
- 🗜️ **自动优化**：大图片自动压缩
- 🌏 **中文优化**：专为豆包模型优化

## 📂 项目包含

- `server.py` - MCP 服务器主程序
- `config.example.json` - 配置示例
- `requirements.txt` - Python 依赖
- `compress.py` - 图片压缩工具
- `diagnose_speed.py` - 速度诊断工具
- 完整文档

## 🆘 获取 API Key

1. 访问 [火山引擎控制台](https://console.volcengine.com/)
2. 开通"火山方舟"服务
3. 创建 API Key
4. 确保有视觉理解模型权限

## 💡 使用示例

```bash
# 描述本地图片
描述: D:/download/photo.jpg

# 描述网络图片
描述: https://example.com/image.jpg

# 自定义提示词
描述: photo.jpg，请用英文描述
```

## 📄 License

MIT License - 自由使用、修改、分发

## 🔗 相关链接

- [iFlow CLI](https://github.com/iflow-ai/iflow-cli)
- [MCP 协议](https://modelcontextprotocol.io/)
- [豆包大模型](https://www.volcengine.com/product/doubao)

---

**版本**: 1.0.0  
**更新**: 2026-02-03  
**分享者**: [Your Name]