Freepik Flux Ai MCP Sunucusu

🚀 Freepik Flux AI MCP 服務

本項目為 Claude Desktop 打造了一個模型上下文協議（MCP）服務器，藉助 Freepik 的 Flux AI 圖像生成服務，能夠依據文本描述生成圖像。

🚀 快速開始

此項目為 Claude Desktop 提供了使用 Freepik 的 Flux AI 圖像生成服務的能力，可從文本描述創建圖像。按照以下步驟，即可快速開啟圖像生成之旅。

✨ 主要特性

• 支持依據文本描述生成圖像。
• 提供多種寬高比選項，滿足多樣化需求。
• 可自動在瀏覽器中打開生成的圖像。
• 具備健壯的錯誤處理和重試機制，保障服務穩定。

📦 安裝指南

環境準備

• 需安裝 Node.js 20.x 或更高版本。
• 你需要獲取 Freepik API 密鑰，可從 https://www.freepik.com/developers/dashboard/api-key 獲取。

安裝步驟

1. 克隆或下載此倉庫：

   git clone https://github.com/grafikogr/freepik-mcp-server.git
   cd freepik-mcp-server
   

2. 安裝依賴項：

   npm install
   

3. 複製 .env.example 文件並重命名為 .env，然後添加 Freepik API 密鑰：

   cp .env.example .env
   

4. 編輯 .env 文件並將 FREEPIK_API_KEY 變量替換為您的 API 密鑰。

💻 使用示例

基礎用法

啟動服務器

npm start

在 Claude Desktop 中啟動服務

在 Claude Desktop 中運行以下命令來啟動該服務器：

@freepik help

高級用法

集成到 Claude Desktop

要在 Claude Desktop 中配置此 MCP 服務器，請按照以下步驟操作：

1. 進入 Claude Desktop 的設置。
2. 在 mcpServers 部分添加以下配置：

   "mcpServers": {
     "freepik": {
       "command": "node",
       "args": ["您下載的路徑/freepik-mcp-server/index.js"]
     }
   }
   

3. 重新啟動 Claude Desktop。

工具使用 - generate_image

根據文本描述和可選的圖像比例生成圖像。

參數：

• prompt：圖像的文本描述（必填）
• aspect_ratio：圖像的比例（可選）

可用圖像比例：

• square_1_1：正方形 (1:1)
• classic_4_3：經典 (4:3)
• traditional_3_4：傳統 (3:4)
• widescreen_16_9：寬屏 (16:9)
• social_story_9_16：社交故事 (9:16)
• standard_3_2：標準 (3:2)
• portrait_2_3：肖像 (2:3)
• horizontal_2_1：水平 (2:1)
• vertical_1_2：垂直 (1:2)
• social_post_4_5：社交帖子 (4:5)

📚 詳細文檔

配置

所有內容都在 config.json 文件中進行配置。

錯誤處理

常見錯誤

• API 密鑰錯誤

Error: Freepik API key is invalid

• 網絡問題

Error: Failed to connect to Freepik server

• 無效的輸入描述

Error: Invalid input description format

解決方法

• API 密鑰錯誤：
  • 檢查您的 API 密鑰是否正確。
  • 確保您已註冊並激活 Freepik 的開發者計劃。
• 網絡問題：
  • 檢查您的互聯網連接。
  • 嘗試更換網絡環境或聯繫您的 Internet Service Provider (ISP)。
• 無效輸入描述：
  • 確保輸入的文本描述符合格式要求。
  • 避免使用特殊字符和不支持的語言。

日誌記錄

服務提供詳細的日誌輸出，便於調試：

# 查看即時日誌
npm run logs

# 查看歷史日誌
npm run history

📄 許可證

此項目在 MIT 許可證下發布。