Imagegen MCP

🚀 🎨 ImageGen MCP Server

ImageGen MCP Server 是一款強大的 MCP 服務器，支持 OpenAI GPT-Image-1、Google Imagen 4、Flux 1.1、Qwen Image、SeedDream-4 和 Nano Banana（Gemini 2.5 Flash Image）等多種 AI 圖像生成模型，為用戶提供便捷高效的圖像生成服務。

🚀 快速開始

選項 1：從 npm 安裝（推薦）

# 全局安裝
npm install -g imagegen-mcp-server

# 或者使用 npx（無需安裝）
npx imagegen-mcp-server

選項 2：從源代碼安裝

# 克隆倉庫
git clone https://github.com/writingmate/imagegen-mcp.git
cd imagegen-mcp

# 安裝依賴
npm install

# 構建項目
npm run build

# 運行服務器
npm start

✨ 主要特性

支持的模型

核心能力

• 多輸出格式：支持 PNG、JPEG、WebP 等多種圖像格式。
• 靈活的尺寸設置：可自定義圖像的尺寸和寬高比。
• Base64 和文件輸出：支持將圖像以 Base64 編碼形式返回或保存到磁盤。
• 種子支持：使用 Flux 模型時可實現可重複的圖像生成。
• MCP 兼容：可與任何 MCP 客戶端無縫協作。

不同客戶端的設置對比

📦 安裝指南

系統要求

• Node.js 18+
• API 密鑰：OPENAI_API_KEY、GOOGLE_API_KEY 和/或 REPLICATE_API_TOKEN

配置環境

在項目目錄下創建一個 .env 文件，並添加以下內容：

# 必需：用於 DALL-E 模型的 OpenAI API 密鑰
OPENAI_API_KEY=your-openai-api-key-here

# 必需：用於 Imagen 和 Gemini 的 Google API 密鑰
GOOGLE_API_KEY=your-google-api-key-here

# 必需：用於 Flux 模型的 Replicate API 令牌
REPLICATE_API_TOKEN=your-replicate-api-token-here

# 可選：自定義 Google Imagen 端點
GOOGLE_IMAGEN_ENDPOINT=

# 可選：生成圖像的輸出目錄（默認：outputs）
OUTPUT_DIR=outputs

獲取 API 密鑰

添加到 MCP 客戶端

• 🚀 WritingMate.ai（推薦 - 無需設置！）：訪問 WritingMate.ai 即可立即開始生成圖像，所有提供商已預配置。
• 🖥️ Claude Desktop：在相應的配置文件中添加以下內容：

{
  "mcpServers": {
    "imagegen": {
      "command": "npx",
      "args": ["imagegen-mcp-server"]
    }
  }
}

• ⌨️ Claude Code CLI：

# 添加到 Claude Code MCP 設置
claude-code config mcp add imagegen npx imagegen-mcp-server

或者手動在設置文件中配置：

{
  "mcpServers": {
    "imagegen": {
      "command": "npx", 
      "args": ["imagegen-mcp-server"]
    }
  }
}

• 📝 Codeium CLI (Codex)：在配置文件中添加：

{
  "mcp_servers": {
    "imagegen": {
      "command": "npx",
      "args": ["imagegen-mcp-server"],
      "env": {}
    }
  }
}

• 🔧 其他 MCP 客戶端：使用命令 npx imagegen-mcp-server，並確保 .env 文件在工作目錄中包含 API 密鑰。

測試安裝

# 測試服務器是否正確啟動
npx imagegen-mcp-server

# 或者如果已全局安裝
imagegen-mcp-server

💻 使用示例

使用 OpenAI GPT-Image-1 生成圖像

const result = await mcpClient.callTool("image.generate.openai", {
  prompt: "A serene mountain landscape at sunset",
  model: "gpt-image-1",
  size: "1536x1024",
  format: "webp",
  background: "transparent",
  quality: "high"
});

使用 Google Gemini 生成圖像

const result = await mcpClient.callTool("image.generate.gemini", {
  prompt: "A futuristic city with flying cars",
  returnBase64: true
});

使用 Flux 1.1 生成圖像

const result = await mcpClient.callTool("image.generate.replicate", {
  prompt: "A detailed portrait of a robot in a cyberpunk setting",
  model: "black-forest-labs/flux-1.1-pro", // 默認模型
  width: 1024,
  height: 1536,
  seed: 12345,
  format: "png"
});

使用 Qwen Image 生成圖像

const result = await mcpClient.callTool("image.generate.replicate", {
  prompt: "A traditional Chinese landscape painting with mountains and rivers",
  model: "qwen/qwen-image",
  width: 1024,
  height: 1024
});

使用 SeedDream-4 生成圖像

const result = await mcpClient.callTool("image.generate.replicate", {
  prompt: "A vibrant abstract art piece with flowing colors",
  model: "bytedance/seedream-4",
  width: 1024,
  height: 1024 // 最小尺寸要求為 1024x1024
});

📚 詳細文檔

可用工具

• OpenAI GPT-Image-1 MCP (image.generate.openai)：使用 OpenAI 最新的 GPT-Image-1 模型和 DALL-E 系列生成圖像。

{
  prompt: string;              // 必需：圖像描述
  model?: string;              // "dall-e-2", "dall-e-3", "gpt-image-1" (默認)
  size?: string;               // "1024x1024", "1792x1024", "1024x1792" 等
  width?: number;              // 替代 size 的方式
  height?: number;             // 替代 size 的方式
  quality?: "standard" | "hd" | "low" | "medium" | "high" | "auto";
  format?: "png" | "jpeg" | "jpg" | "webp";
  background?: "transparent" | "opaque" | "auto"; // 僅適用於 gpt-image-1
  style?: "vivid" | "natural";  // 僅適用於 DALL-E 3
  returnBase64?: boolean;      // 在響應中包含 Base64 編碼的圖像
  filenameHint?: string;       // 自定義文件名前綴
}

• Google Imagen 4 MCP (image.generate.google)：通過自定義端點使用 Google 的先進 Imagen 4 模型生成圖像。

{
  prompt: string;              // 必需：圖像描述
  model?: string;              // 模型名稱
  size?: string;               // 圖像尺寸
  quality?: string;            // 質量設置
  format?: "png" | "jpeg" | "jpg" | "webp";
  returnBase64?: boolean;
  filenameHint?: string;
}

• Nano Banana MCP (image.generate.gemini)：使用 Google 的 Gemini 2.5 Flash Image Preview 模型生成圖像。

{
  prompt: string;              // 必需：圖像描述
  model?: string;              // 默認："gemini-2.5-flash-image-preview"
  returnBase64?: boolean;
  filenameHint?: string;
}

• Replicate Models MCP (image.generate.replicate)：通過 Replicate API 使用多個前沿模型生成圖像。

{
  prompt: string;              // 必需：圖像描述
  model?: string;              // 默認："black-forest-labs/flux-1.1-pro"
  width?: number;              // 圖像寬度（默認：1024）
  height?: number;             // 圖像高度（默認：1024）
  size?: string;               // 替代格式："1024x1024"
  format?: "png" | "jpeg" | "jpg" | "webp";
  seed?: number;               // 可重複生成的種子值
  returnBase64?: boolean;
  filenameHint?: string;
}

輸出格式

所有工具返回的響應格式一致：

{
  content: [
    {
      type: "text",
      text: "provider=openai model=gpt-image-1 saved=/path/to/image.png"
    },
    {
      type: "image",        // 僅當 returnBase64: true 時存在
      data: "base64data",
      mimeType: "image/png"
    }
  ]
}

生成的圖像將自動保存到配置的輸出目錄中，並使用帶時間戳的文件名。

發佈到 npm

# 更新版本
npm version patch|minor|major

# 發佈
npm publish

API 密鑰設置

• OpenAI API 密鑰：訪問 OpenAI API Keys 創建新的 API 密鑰，並添加到 .env 文件中。
• Google API 密鑰：訪問 Google AI Studio 創建 API 密鑰並啟用所需的 API，然後添加到 .env 文件中。
• Replicate API 令牌：訪問 Replicate 註冊並創建 API 令牌，添加到 .env 文件中。

開發

npm install    # 安裝依賴
npm run dev    # 開發模式，支持熱重載
npm run build  # 構建生產版本
npm start      # 啟動生產服務器

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。