Image Gen3 Google MCP Server

🚀 雙子星 Imagen 3.0 MCP 服務器

一款專業的模型上下文協議（MCP）服務器實現，藉助 Google 的 Imagen 3.0 模型與雙子星 API 進行高質量圖像生成。採用 TypeScript 構建，專為與 Claude Desktop 及其他 MCP 兼容主機無縫集成而設計。

🚀 快速開始

先決條件

• Node.js 18 或更高版本
• Google 雙子星 API 密鑰
• Claude Desktop 或其他 MCP 兼容主機

安裝

1. 克隆倉庫：

git clone https://github.com/yourusername/gemini-imagen-mcp-server.git
cd gemini-imagen-mcp-server

2. 安裝依賴項：

npm install

3. 構建 TypeScript 代碼：

npm run build

✨ 主要特性

• 利用 Google 最新的 Imagen 3.0 模型通過雙子星 API
• 每次請求最多生成 4 張高質量圖像
• 自動文件管理，帶有智能命名
• 支持 HTML 預覽生成和 file:// 協議訪問
• 基於 MCP 協議的 AI 代理兼容性
• 使用 TypeScript 實現，具備強大的錯誤處理能力

📦 安裝指南

配置

1. 在 claude_desktop_config.json 中添加配置：

{
  "mcpServers": {
    "gemini-image-gen": {
      "command": "node",
      "args": ["./build/index.js"],
      "cwd": "<項目目錄路徑>",
      "env": {
        "GEMINI_API_KEY": "你的雙子星 API 密鑰"
      }
    }
  }
}

2. 替換佔位符：
   • <項目目錄路徑>：你的項目路徑
   • 你的雙子星 API 密鑰：你的雙子星 API 密鑰

💻 使用示例

基礎用法

# 在終端中運行以下命令來生成圖像
node generate_images.js --prompt "一隻飛翔的鳥" --numberOfImages 3

# 查看日誌
node view_logs.js

📚 詳細文檔

可用工具

1. generate_images

使用 Google 的 Imagen 3.0 模型生成圖像。 參數：

• prompt（必需）：圖像描述的文本
• numberOfImages（可選）：要生成的圖像數量，默認為 1

2. view_logs

查看服務器日誌。

開發信息

項目結構

• src/: 包含核心邏輯和模塊。
• build/: 存放構建後的文件。

運行時依賴

• Node.js：用於運行服務器。
• npm/yarn：用於管理依賴項。

🔧 技術細節

錯誤處理

常見錯誤

1. API 調用失敗
   • 檢查網絡連接和 API 密鑰是否正確。
   • 查看日誌以獲取詳細錯誤信息。
2. 模塊未找到
   • 確保所有依賴項已正確安裝。
   • 檢查文件路徑是否正確。

📄 許可證

本項目遵循 MIT 協議。詳情請參閱 LICENSE。

💻 作者信息

聯繫方式

• 郵箱：[你的郵箱地址]
• GitHub：[你的 GitHub 鏈接]

致謝

感謝所有貢獻者和開源社區的支持！

⚠️ 重要提示

確保 API 密鑰安全，避免洩露。在生產環境中，請根據需要配置相關安全措施。

由 Falah G. Salih 熱愛打造