Universal Image Generator MCP

🚀 通用圖像生成器MCP服務器

通用圖像生成器MCP服務器是一個支持多供應商的AI圖像生成服務器，供MCP客戶端使用。藉助該服務器，你可以通過任何與MCP兼容的應用程序，利用谷歌（Imagen & Gemini）、智譜AI的CogView - 4或阿里巴巴的百鍊模型來生成高質量的圖像。

🚀 快速開始

1. 通過uvx安裝

無需手動安裝！服務器將自動下載並運行。

2. 獲取API密鑰

選擇一個供應商並獲取API密鑰：

• 谷歌：谷歌AI工作室（支持Imagen和Gemini模型）
• 智譜AI：智譜AI平臺
• 百鍊：阿里巴巴魔搭

3. 配置MCP客戶端

將以下內容添加到你的MCP客戶端配置文件（例如claude_desktop_config.json）中：

{
    "mcpServers": {
        "universal-image-generator": {
            "command": "uvx",
            "args": [
                "universal-image-generator-mcp"
            ],
            "env": {
                "IMAGE_PROVIDER": "google",
                "GOOGLE_MODEL": "gemini",
                "ZHIPU_API_KEY": "your-api-key-here",
                "GEMINI_API_KEY": "your-api-key-here",
                "DASHSCOPE_API_KEY": "your-api-key-here",
                "OUTPUT_IMAGE_PATH": "/path/to/save/images"
            }
        }
    }
}

環境變量說明：

• IMAGE_PROVIDER：可以是"google"、"zhipuai"或"bailian"
• GOOGLE_MODEL：可以是"gemini"或"imagen"（僅適用於谷歌供應商，默認為"gemini"）
• 為你選擇的供應商設置相應的API密鑰
• OUTPUT_IMAGE_PATH：保存生成圖像的目錄（可選）

✨ 主要特性

• 多供應商支持：可在谷歌（Imagen/Gemini）、智譜AI或百鍊之間進行選擇。
• 圖像生成：所有供應商均支持文本到圖像的生成。
• 圖像轉換：僅谷歌和百鍊支持對現有圖像進行編輯。
• 智能語言優化：自動進行提示詞翻譯和優化。
• 本地存儲：可將生成的圖像保存到指定目錄。

📦 安裝指南

見上述快速開始部分。

💻 使用示例

配置完成後，你可以向你的AI助手提出以下請求：

• "生成一幅山脈上日落的圖像"
• "創建一個在科幻城市中3D渲染的飛豬圖像"
• "通過給這個場景添加雪來轉換這幅圖像"

生成的圖像將保存到你配置的輸出目錄中。

可用工具

generate_image_from_text

根據文本描述創建圖像。

generate_image_from_text(prompt: str, model_type: Optional[str] = None) -> str

參數：

• prompt：要生成圖像的文本描述。
• model_type：谷歌供應商的可選模型選擇（"gemini"或"imagen"）
  • 僅適用於谷歌供應商。
  • 如果未指定，則使用GOOGLE_MODEL環境變量（默認為"gemini"）。

transform_image_from_encoded （僅谷歌和百鍊支持）

使用Base64編碼的圖像數據轉換圖像。

transform_image_from_encoded(encoded_image: str, prompt: str) -> str

transform_image_from_file （僅谷歌和百鍊支持）

轉換現有的圖像文件。

transform_image_from_file(image_file_path: str, prompt: str) -> str

示例輸出

提示詞："創建一個戴著禮帽、長著翅膀的豬在充滿綠色植物的未來科幻城市上空飛行的3D渲染圖像"

轉換提示："添加一隻可愛的小鯨魚和豬一起飛行"

📚 詳細文檔

供應商能力

注意：對於谷歌供應商，圖像轉換僅支持Gemini模型，Imagen僅用於圖像生成。

🔧 技術細節

本地開發測試

git clone https://github.com/ECNU3D/universal-image-generator-mcp.git
cd universal-image-generator-mcp
fastmcp dev src/universal_image_generator_mcp/server.py

訪問 http://localhost:5173/ 使用MCP檢查器進行測試。

📄 許可證

本項目採用MIT許可證。