Freepik Flux Ai MCP Sunucusu

🚀 Freepik Flux AI MCP サービス

このプロジェクトは、Claude Desktop で Freepik の Flux AI 画像生成サービスを使用し、テキスト記述から画像を作成するモデルコンテキストプロトコル（MCP）サーバーを提供します。

🚀 クイックスタート

この Freepik Flux AI MCP サービスを使用することで、Claude Desktop 内でテキスト記述から画像を生成できます。以下の手順に従ってサービスをセットアップしてください。

✨ 主な機能

• テキスト記述から画像を生成する
• 複数の画像アスペクト比を選択できる
• 生成された画像を自動的にブラウザで開く
• 堅牢なエラーハンドリングとリトライ機構

📦 インストール

前提条件

• 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 への統合方法は以下の通りです。

1. Claude Desktop の設定にアクセスします。
2. mcpServers セクションに以下の設定を追加します。

"mcpServers": {
  "freepik": {
    "command": "node",
    "args": ["あなたがダウンロードしたパス/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)

設定

すべての設定は config.json ファイルで行います。

エラーハンドリング

一般的なエラー

• API キーエラー

Error: Freepik API key is invalid

• ネットワーク問題

Error: Failed to connect to Freepik server

• 無効な入力記述

Error: Invalid input description format

解決策

• API キーエラー
  • API キーが正しいことを確認してください。
  • Freepik の開発者プランに登録し、アクティベートされていることを確認してください。
• ネットワーク問題
  • インターネット接続を確認してください。
  • ネットワーク環境を変更するか、インターネットサービスプロバイダー（ISP）に問い合わせてください。
• 無効な入力記述
  • 入力されたテキスト記述が形式要件を満たしていることを確認してください。
  • 特殊文字やサポートされていない言語の使用を避けてください。

ログ記録

サービスは詳細なログ出力を提供し、デバッグを容易にします。

# リアルタイムログを表示
npm run logs

# 履歴ログを表示
npm run history

📄 ライセンス

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