Freepik MCPサーバー

Freepik の API と対話するための MCP サーバー実装。ストック写真や Mystic AI 画像生成機能へのアクセスを提供します。

特徴

Freepikのリソース（写真、ベクター、PSD）を検索
詳細なリソース情報を取得する
リソースをダウンロード
Mystic AIを使用して画像を生成する
画像生成ステータスを確認する

前提条件

Node.js 18以上
Freepik API キー（ API セットアップガイドを参照）

インストール

# Create a new directory for your MCP servers
mkdir mcp-servers
cd mcp-servers

# Clone the repository
git clone https://github.com/MCERQUA/freepik-mcp.git
cd freepik-mcp

# Install dependencies
npm install

# Build the server
npm run build

構成

まず、 API_SETUP.mdの指示に従ってFreepik APIキーを取得します。
サーバーを 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 リソースを検索します。

{
  term?: string;          // Search term
  limit?: number;         // Results per page
  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;
    };
  };
}

リソースを取得する

特定のリソースに関する詳細情報を取得します。

{
  id: number;  // Resource ID to get details for
}

ダウンロードリソース

特定のリソースのダウンロード URL を取得します。

{
  id: number;  // Resource ID to download
}

画像を生成する

Freepik Mystic AI を使用して画像を生成します。

{
  prompt: string;         // Text description of the image to generate
  resolution?: '2k' | '4k';
  aspect_ratio?: 'square_1_1' | 'classic_4_3' | 'traditional_3_4' | 
                 'widescreen_16_9' | 'social_story_9_16';
  realism?: boolean;      // Enable realistic style
  engine?: 'automatic' | 'magnific_illusio' | 'magnific_sharpy' | 'magnific_sparkle';
  creative_detailing?: number;  // 0-100
}

チェックステータス

Mystic 画像生成タスクのステータスを確認します。

{
  task_id: string;  // ID of the generation task to check
}

発達

# Install dependencies
npm install

# Build the server
npm run build

# Run in development mode
npm run dev

エラー処理

サーバーは包括的なエラー処理を実装します。

APIエラーは詳細情報とともに記録されます
Zodスキーマを使用した入力検証
コンテキストに応じた適切なエラー応答
レート制限の認識

貢献

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

ライセンス

マサチューセッツ工科大学

Freepik MCP Server

Integrations