# LiblibAI Picture Generator 使用说明
## 📋 项目概述
这是一个基于LiblibAI API的通用AI图片生成工具,提供了完整的MCP(Model Context Protocol)集成,支持各种风格的图片生成和状态查询功能。
## 🚀 快速开始
### 1. 安装依赖
```bash
pip install -r requirements.txt
```
### 2. 配置Claude Desktop
将 `claude-desktop-picture-config.json` 的内容添加到您的Claude Desktop配置文件中。
### 3. 启动测试
```bash
python picture.py
```
## 🛠️ 功能说明
### MCP工具函数
#### `create_image(prompt, width, height)`
- **功能**: 根据提示词生成AI图片
- **参数**:
- `prompt` (必须): 图片描述,支持中文和英文
- `width` (可选): 图片宽度,默认768像素
- `height` (可选): 图片高度,默认768像素
- **返回**: 任务提交结果和任务ID
#### `check_image_status(task_id)`
- **功能**: 查询图片生成状态
- **参数**: `task_id` - 生成任务的ID
- **返回**: 生成状态、进度或最终图片链接
#### `generate_and_wait(prompt, width, height, max_wait)`
- **功能**: 一站式生成并等待完成
- **参数**:
- `prompt` (必须): 图片描述
- `width` (可选): 图片宽度
- `height` (可选): 图片高度
- `max_wait` (可选): 最大等待时间,默认120秒
- **返回**: 最终生成结果
#### `health_check()`
- **功能**: 系统健康检查
- **返回**: 服务运行状态
## 🎨 使用示例
### 在Claude中使用:
```
请生成一张美丽的风景画
```
### 或者指定参数:
```
使用 create_image("一只可爱的小猫", 1024, 1024) 生成图片
```
### 查询状态:
```
使用 check_image_status("任务ID") 查询生成进度
```
### 一站式生成:
```
使用 generate_and_wait("夕阳下的城市天际线") 生成并等待完成
```
## 🔧 配置说明
### API密钥配置
在 `claude-desktop-picture-config.json` 中配置您的LiblibAI API密钥:
- `LIBLIB_ACCESS_KEY`: 您的AccessKey
- `LIBLIB_SECRET_KEY`: 您的SecretKey
### 当前配置的密钥
- AccessKey: `HNFdsJW-ORm6YLXuvB2K0Q`
- SecretKey: `IDBeMrtjX1chykv9w-ydfBXnDBy_ebbH`
## 📝 生成示例
### 风景类
- "山水风景画,中国水墨画风格"
- "sunset over ocean waves, dramatic lighting"
- "春天的花海,蓝天白云"
### 人物类
- "可爱的小女孩,动漫风格"
- "portrait of an elderly man, realistic style"
- "古代武士,中国风格"
### 动物类
- "一只橙色的小猫在花园里"
- "majestic lion in savanna, wildlife photography"
- "中国龙,传统艺术风格"
## 📁 文件结构
```
d:\mcpdemo\demo\
├── picture.py # 主程序文件
├── claude-desktop-picture-config.json # Claude Desktop配置
├── requirements.txt # 依赖包列表
└── README_PICTURE.md # 使用说明(本文件)
```
## ✨ 特色功能
- 🎨 支持各种风格的AI图片生成
- 🚀 快速响应的MCP集成
- 📊 实时生成进度查询
- 💰 账户积分余额显示
- 🔄 一站式生成等待服务
- 🛡️ 完善的错误处理机制
## 💡 使用提示
1. 首次使用建议先运行 `health_check()` 确认服务正常
2. 生成图片通常需要10-60秒时间
3. 可以使用 `generate_and_wait()` 获得一站式体验
4. 每次生成会消耗一定积分,请注意账户余额
5. 支持中英文混合描述,英文提示词通常效果更好