多提供商图像生成服务器

一个支持多提供商、自动回退机制的图像生成服务器,适用于AGI视觉通信和游戏资产创建。

  • by marc-shade
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 marc-shade/image-gen-mcp

使用说明

图像生成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 -稳定扩散XL
  • sdxl-lightning -快速4步SDXL
  • flux-schnell -快速通量
  • dreamshaper -照片级写实

拥抱脸

  • sdxl -稳定扩散XL
  • sdxl-turbo -快速SDXL
  • flux-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 -稳定扩散XL
  • playground-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

错误处理

如果一个提供者失败,服务器会自动通过提供者回退:

  1. 尝试请求的提供商(或轮询)
  2. 如果失败,请尝试Cloudflare
  3. 如果失败,请尝试Together AI
  4. 如果失败,尝试拥抱脸
  5. 如果失败,请尝试复制
  6. 所有尝试的提供程序都返回错误

未来的增强功能

  • []12GB GPU可用时,支持本地GPU(Flux/ComfyUI)
  • []图像到图像生成
  • []内画和外画
  • []升级
  • []风格转换
  • []动画生成

许可证

麻省理工学院