使用说明
图像生成MCP服务器
用于AGI视觉传达的多提供商图像生成。
特性
- 多提供商支持:跨5个提供商自动回退
- 免费默认:Pollings.ai不需要API密钥
- 像素艺术模式:精灵和游戏资产的专业生成
- 自动保存:生成的图像自动保存到磁盘
- 成本跟踪:监控每个提供商的使用情况和成本
提供商
| 提供商 | 成本 | API密钥 | 最适合 |
|---|---|---|---|
| 投票.ai | 免费 | 无 | 默认,一般使用 |
| Cloudflare人工智能 | 10K神经元/天免费 | 必需 | 快速,生产 |
| 一起AI | ~0.003美元/张 | 必需 | 批量生成 |
| 拥抱脸 | 免费等级 | 必填 | 型号多样 |
| 复制 | 每月50美元免费 | 必需 | 高品质 |
安装
cd /mnt/agentic-system/mcp-servers/image-gen-mcp
pip install -e .
配置
添加 ~/.claude.json:
{
"mcpServers": {
"image-gen": {
"command": "python",
"args": ["-m", "image_gen_mcp.server"],
"env": {
"CLOUDFLARE_API_TOKEN": "your-token",
"CLOUDFLARE_ACCOUNT_ID": "your-account-id",
"HUGGINGFACE_API_TOKEN": "your-hf-token",
"TOGETHER_API_KEY": "your-together-key",
"REPLICATE_API_TOKEN": "your-replicate-token",
"IMAGE_GEN_OUTPUT_DIR": "/mnt/agentic-system/generated-images"
}
}
}
}
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
IMAGE_GEN_OUTPUT_DIR |
否 | 保存图像的位置(默认: /mnt/agentic-system/generated-images) |
CLOUDFLARE_API_TOKEN |
对于CF | Cloudflare API令牌 |
CLOUDFLARE_ACCOUNT_ID |
对于CF | Cloudflare帐户ID |
HUGGINGFACE_API_TOKEN |
HF | 拥抱脸代币 |
TOGETHER_API_KEY |
For Together | Together AI键 |
REPLICATE_API_TOKEN |
用于复制 | 复制令牌 |
MCP工具
generate_image
从文本提示生成图像。
{
"prompt": "A corgi wearing a space helmet, pixel art style",
"width": 1024,
"height": 1024,
"provider": "pollinations",
"model": "flux",
"seed": 42,
"save_to_file": true
}
generate_pixel_art
专业像素艺术生成。
{
"prompt": "cute corgi sprite, side view",
"style": "nes",
"size": 64,
"colors": 16
}
样式: nes, snes, gameboy, modern, isometric
list_providers
列出所有具有状态的提供者。
list_models
列出提供程序的型号。
{
"provider": "huggingface"
}
get_provider_status
对提供者进行健康检查。
save_image
将base64图像保存到文件。
按提供商分类的模型
投票.ai
flux(默认)-高质量flux-realism-照片级写实flux-anime-动漫风格flux-3d-3D渲染turbo-快速生成
Cloudflare人工智能
sdxl-稳定扩散XLsdxl-lightning-快速4步SDXLflux-schnell-快速通量dreamshaper-照片级写实
拥抱脸
sdxl-稳定扩散XLsdxl-turbo-快速SDXLflux-dev-焊剂开发flux-schnell-快速通量playground-v2.5-美学realvisxl-照片级写实pixel-art-像素艺术专业
一起AI
flux-schnell-免费等级可用flux-dev-更高的质量flux-pro-最佳品质sd3-稳定扩散3
复制
flux-schnell-快速通量flux-dev-更高的质量flux-pro-最佳品质sdxl-稳定扩散XLplayground-v2.5-美学
使用示例
基本图像生成
Generate an image of a mountain landscape at sunset
精灵像素艺术
Generate pixel art of a corgi walking animation, NES style, 64x64
与特定提供商合作
Generate a photorealistic portrait using Cloudflare's SDXL model
输出
图像保存到 IMAGE_GEN_OUTPUT_DIR 格式:
{timestamp}_{prompt_snippet}_{provider}.png
例子: 20241128_143022_mountain_landscape_pollinations.png
错误处理
如果一个提供者失败,服务器会自动通过提供者回退:
- 尝试请求的提供商(或轮询)
- 如果失败,请尝试Cloudflare
- 如果失败,请尝试Together AI
- 如果失败,尝试拥抱脸
- 如果失败,请尝试复制
- 所有尝试的提供程序都返回错误
未来的增强功能
- []12GB GPU可用时,支持本地GPU(Flux/ComfyUI)
- []图像到图像生成
- []内画和外画
- []升级
- []风格转换
- []动画生成
许可证
麻省理工学院