Freepik MCP

🚀 Freepik MCP 服務器

Freepik MCP 服務器是一個用於與 Freepik API 交互的實現方案。它提供了對庫存照片和 Mystic AI 圖像生成功能的訪問，能幫助用戶更便捷地使用 Freepik 的各類資源。

🚀 快速開始

在使用 Freepik MCP 服務器之前，你需要完成一些先決條件的準備，然後進行安裝和配置。

先決條件

• Node.js 18 或更高版本
• Freepik API 密鑰（參見 API 設置指南）

安裝

# 創建一個新的 MCP 服務器目錄
mkdir mcp-servers
cd mcp-servers

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

# 安裝依賴項
npm install

# 構建服務器
npm run build

配置

1. 首先，按照 API_SETUP.md 中的說明獲取您的 Freepik API 密鑰。
2. 將服務器添加到您的 MCP 設置文件中：

{
  "mcpServers": {
    "freepik": {
      "command": "node",
      "args": ["path/to/freepik-mcp/build/index.js"],
      "env": {
        "FREEPIK_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

✨ 主要特性

• 搜索 Freepik 資源（照片、向量、PSD）
• 獲取資源詳細信息
• 下載資源
• 使用 Mystic AI 生成圖像
• 檢查圖像生成狀態

💻 使用示例

可用工具

search_resources

使用各種過濾器搜索 Freepik 資源：

{
  term?: string;          // 搜索詞
  limit?: number;         // 每頁結果數
  order?: 'relevance' | 'recent';
  filters?: {
    orientation?: {
      landscape?: boolean;
      portrait?: boolean;
      square?: boolean;
      panoramic?: boolean;
    };
    content_type?: {
      photo?: boolean;
      psd?: boolean;
      vector?: boolean;
    };
    license?: {
      freemium?: boolean;
      premium?: boolean;
    };
  };
}

get_resource

獲取特定資源的詳細信息：

{
  id: number;  // 要獲取詳細信息的資源 ID
}

download_resource

獲取特定資源的下載鏈接：

{
  id: number;  // 要下載的資源 ID
}

generate_image

使用 Freepik Mystic AI 生成圖像：

{
  prompt: string;         // 圖像描述的文字
  resolution?: '2k' | '4k';
  aspect_ratio?: 'square_1_1' | 'classic_4_3' | 'traditional_3_4' | 
                 'widescreen_16_9' | 'social_story_9_16';
  realism?: boolean;      // 啟用現實風格
  engine?: 'automatic' | 'magnific_illusio' | 'magnific_sharpy' | 'magnific_sparkle';
  creative_detailing?: number;  // 0-100
}

check_status

檢查 Mystic 圖像生成任務的狀態：

{
  task_id: string;  // 要檢查的生成任務 ID
}

🔧 技術細節

該服務器實現了全面的錯誤處理：

• 記錄 API 錯誤的詳細信息
• 使用 Zod 模式進行輸入驗證
• 提供帶有上下文的正確錯誤響應
• 注意限流意識

📚 詳細文檔

開發

# 安裝依賴項
npm install

# 構建服務器
npm run build

# 在開發模式下運行
npm run dev

貢獻

1. 叉存倉庫
2. 創建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加一些很棒的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打開 Pull Request

📄 許可證

MIT