Freepik

🚀 Freepik MCP サーバー

FreepikのAPIと相互作用するMCPサーバーの実装です。在庫写真やMystic AIによる画像生成機能にアクセスできます。

🚀 クイックスタート

このFreepik MCPサーバーを使用することで、FreepikのAPIと相互作用し、在庫写真やMystic AI画像生成機能にアクセスできます。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

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

📦 インストール

前提条件

• 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": []
    }
  }
}

利用可能なツール

💻 基本的な使用法

search_resources

様々なフィルターを使用してFreepikのリソースを検索します。

{
  term?: string;          // 検索キーワード
  limit?: number;         // 1ページあたりの結果数
  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

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

{
  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
}

開発

# 依存関係をインストール
npm install

# サーバーをビルド
npm run build

# 開発モードで実行
npm run dev

エラー処理

このサーバーは、包括的なエラー処理を実装しています。

• APIエラーの詳細情報を記録する
• Zodスキーマを使用した入力検証
• コンテキストを持つ正しいエラー応答
• レート制限に対応

貢献方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)
3. 変更をコミットします (git commit -m "your-message")
4. ブランチにプッシュします (git push origin feature/amazing-feature)
5. プルリクエストを開きます。

その他

このプロジェクトの使用方法に関する詳細情報は、プロジェクトドキュメントを参照してください。