Skip to main content
Glama
enesjakozh
MCERQUA

Freepik MCP Server

by MCERQUA
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

Freepik MCPサーバー

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

特徴

  • Freepikのリソース（写真、ベクター、PSD）を検索

  • 詳細なリソース情報を取得する

  • リソースをダウンロード

  • Mystic AIを使用して画像を生成する

  • 画像生成ステータスを確認する

Related MCP server: Freepik FastMCP Toolkit

前提条件

インストール

# 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

構成

  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 リソースを検索します。

{
  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スキーマを使用した入力検証

  • コンテキストに応じた適切なエラー応答

  • レート制限の認識

貢献

  1. リポジトリをフォークする

  2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）

  3. 変更をコミットします ( git commit -m 'Add some amazing feature' )

  4. ブランチにプッシュする ( git push origin feature/amazing-feature )

  5. プルリクエストを開く

ライセンス

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers