Image Gen Server

🚀 圖像生成服務器

本項目 Image-Gen-Server 是基於即夢 AI 的圖像生成服務，致力於與 Cursor IDE 集成。它能依據文本描述生成圖片，還具備下載和保存功能，為圖像生成需求提供了便捷的解決方案。

🚀 快速開始

Image-Gen-Server 是專為與 Cursor IDE 集成而打造的圖像生成服務。藉助該服務，你可以通過文本描述輕鬆生成圖片，並進行下載和保存操作。

✨ 主要特性

1. 💯 完美集成：支持與 Cursor 和 Claude 等工具無縫集成，為用戶提供統一的操作體驗。
2. 📝 文本到圖像生成：只需輸入文本描述，即可生成高質量的圖像，滿足多樣化的創作需求。
3. 💾 自動保存：自動生成並保存圖片文件，節省用戶手動操作的時間。
4. 📂 自定義路徑：允許用戶設置圖片保存的目錄，方便管理生成的圖片。
5. 📦 批量生成：一次可生成四張不同風格的圖片，提高創作效率。

📦 安裝指南

1. 使用 Smithery CLI 安裝

smith install image-gen-server

2. 手動安裝

1. 克隆項目倉庫：

   git clone https://github.com/your-username/image-gen-server.git
   cd image-gen-server
   

2. 安裝依賴項：
   • Python 環境要求：使用 Python 3.8 或更高版本。
   • 安裝依賴：

     pip install fastmcp proxy[jimeng]
     

3. 配置項目：
   • 修改 server.py 文件中的 IMG_SAVA_FOLDER 變量以設置默認保存路徑。
   • 配置 config.json 文件，添加即夢 AI 的 API 密鑰。

📚 詳細文檔

在 Cursor 中集成

1. 打開 Cursor 設置

• 點擊菜單欄的 Cursor > Settings

2. 添加 MCP 服務器

• 進入 Tools 部分，選擇 MCP Servers
• 點擊 Add Server 按鈕
• 填寫以下信息：
  • Name: Image-Gen-Server
  • Command:

    uv run --with fastmcp fastmcp run D:/path/to/server.py
    

  • Working Directory: 設置為服務器腳本所在的目錄

3. 完成配置

• 點擊 Add，完成服務器的添加。

使用說明

1. 在 Cursor 的 Agent 模式下

• 示例 1：根據項目需求生成產品 logo 並保存到項目目錄下的 images 文件夾。
• 示例 2：為網站首頁製作 banner 圖片。

2. 調用接口

from image_gen_server import generate_image

images = generate_image(
    prompt="設計一個現代簡約風格的logo",
    save_path="path/to/images/logo.jpg",
    width=1024,
    height=1024
)

常見問題解決

1. 配置完成後跳出黑窗口且很快消失

• 可能原因：
  • 服務器命令填寫錯誤，檢查路徑是否正確，確保不包含中文字符，並使用一致的路徑分隔符。
  • 環境未正確安裝，確認已安裝所有依賴項。
  • 使用的終端與配置不符，嘗試在不同的終端運行（如 Git Bash、Cmd、PowerShell 或 WSL）。

2. 調試服務器

uv run --with fastmcp fastmcp dev D:/path/to/server.py

這會打開一個調試界面：http://localhost:5173/，可通過瀏覽器訪問 MCP Inspector 進行調試。

更多詳細信息請參考項目文檔和相關技術資料。

🔧 技術細節

• server.py 使用了 fastmcp 庫實現了 MCP 服務器功能，為 Cursor 和 Claude 提供服務。
• 調用了 proxy.jimeng 模塊與即夢 AI 進行交互，支持以下功能：
  • 圖像生成 (generate_images)
  • 同步對話補全 (create_completion)
  • 流式對話補全 (create_completion_stream)
  • 支持多賬號 token
  • 完整的錯誤處理機制

💻 使用示例

基礎用法

# 在 Cursor 的 Agent 模式下：
# 示例一：生成產品 logo
根據提供過你的項目需求，幫我生成一張產品logo，放在項目目錄images下面

# 示例二：設計網站首頁 banner
根據項目需求，幫我製作網站的首頁，頭部需要有banner圖片。

📄 許可證

本項目採用 MIT License，作者為凌封。