Freepik MCPサーバー
Freepik の API と対話するための MCP サーバー実装。ストック写真や Mystic AI 画像生成機能へのアクセスを提供します。
特徴
Freepikのリソース（写真、ベクター、PSD）を検索
詳細なリソース情報を取得する
リソースをダウンロード
Mystic AIを使用して画像を生成する
画像生成ステータスを確認する
Related MCP server: Meilisearch MCP Server
前提条件
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)プルリクエストを開く
ライセンス
マサチューセッツ工科大学