Freepik Flux AI MCP Sunucusu

Freepik Flux AI MCP サーバー

このプロジェクトは、Claude Desktop 向けの Model Context Protocol（MCP）サーバーです。Freepik の Flux AI 画像生成サービスを使用して、テキストの説明から画像を生成します。

機能

• テキストの説明から画像を生成
• さまざまなアスペクト比のオプション
• ブラウザーで画像を自動的に開く
• 堅牢なエラー処理と再試行の仕組み

必要条件

• Node.js 20.x 以上
• Freepik API キー（https://www.freepik.com/developers/dashboard/api-key から取得できます）

インストール

1. このリポジトリをクローンするか、ダウンロードします：

git clone https://github.com/grafikogr/freepik-mcp-server.git
cd freepik-mcp-server

2. 依存関係をインストールします：

npm install

3. .env.example ファイルを .env としてコピーし、Freepik API キーを追加します：

cp .env.example .env

4. .env ファイルを編集し、FREEPIK_API_KEY 変数を自分の API キーに置き換えます。

使い方

1. サーバーを起動します：

npm start

2. Claude Desktop アプリで、次のコマンドを使ってこのサーバーを実行します：

@freepik help

Claude Desktop との連携

Claude Desktop で MCP サーバーを設定するには、次の手順に従います：

1. Claude Desktop の設定に移動します。
2. mcpServers セクションに次の設定を追加します：

"mcpServers": {
  "freepik": {
    "command": "node",
    "args": ["indirdiğiniz/konum/freepik-mcp-server/index.js"]
  }
}

3. Claude Desktop を再起動します。

ツール

generate_image

テキストの説明と画像のアスペクト比（任意）を指定して、画像を生成します。

パラメーター：

• prompt：画像のテキスト説明（必須）
• aspect_ratio：画像のアスペクト比（任意）

使用可能なアスペクト比：

• square_1_1：正方形（1:1）
• classic_4_3：クラシック（4:3）
• traditional_3_4：トラディショナル（3:4）
• widescreen_16_9：ワイドスクリーン（16:9）
• social_story_9_16：ソーシャルメディアストーリー（9:16）
• standard_3_2：スタンダード（3:2）
• portrait_2_3：ポートレート（2:3）
• horizontal_2_1：横長（2:1）
• vertical_1_2：縦長（1:2）
• social_post_4_5：ソーシャルメディア投稿（4:5）

設定

.env ファイルで、次の設定を構成できます：

• FREEPIK_API_KEY：Freepik API キー（必須）
• REQUEST_TIMEOUT：リクエストのタイムアウト時間（ミリ秒、デフォルト：30000）
• RETRY_ATTEMPTS：失敗したリクエストの再試行回数（デフォルト：3）

例

1. シンプルな画像を生成する：

   @freepik Bana bir kedi görseli oluştur
   

2. 指定したアスペクト比で画像を生成する：

   @freepik Bana widescreen_16_9 oranında dağ manzarası oluştur
   

トラブルシューティング

• API キーに関する問題が発生した場合は、.env ファイルを確認し、Freepik API キーが正しいことを確かめてください。
• ネットワーク接続の問題が発生した場合は、インターネット接続を確認してください。
• サーバーの実行に問題がある場合は、Node.js のバージョンが 20.x 以上であることを確認してください。
• 詳細なデバッグ情報については、コンソール出力を確認してください。

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。