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