Freepik MCP

🚀 Freepik FastMCP Toolkit

🚀 Freepik APIをシームレスに統合するMCPサーバー

このツールキットは、Model Context Protocol (MCP) サーバーを提供し、ClaudeやCursorなどのAIアシスタントをFreepikの強力なAPIに直接接続します。AIワークフローから離れることなく、ビジュアルコンテンツの生成、検索、管理が可能です。

🚀 クイックスタート

このセクションでは、Freepik FastMCP Toolkitをすぐに使い始めるための手順を説明します。

✨ 主な機能

• 🎨 アイコン検索とダウンロード - 複数の形式のアイコンを検索してダウンロードできます。
• 📁 リソース管理 - マルチメディアコンテンツにアクセスし、管理できます。
• 🤖 AI画像分類 - 画像を自動的に分類して分析します。
• 🖼️ 画像生成 - Mystic AIを使ってカスタム画像を作成します。

📦 インストール

前提条件

インストールを始める前に、以下が必要です。

• Python 3.12以上 がインストールされていること
• uv 依存関係マネージャー（ここからインストール）
• Freepik APIキー（ここで取得）

インストール手順

1. リポジトリをクローンして移動

git clone <REPOSITORY_URL>
cd freepik-toolkit/fastmcp

2. Makefileを使ってインストール

# 依存関係をインストール
make install

# インストールを確認
make version

3. APIキーを設定

echo "FREEPIK_API_KEY=your_api_key_here" > .env

💡 APIキーはここで取得できます: freepik.com/api

💻 使用例

基本的な使用法

# 開発モード（自動リロード）
make dev

# 本番モード
make run

# コード品質をチェック
make lint

# コードを整形
make format

# 一時ファイルをクリーンアップ
make clean

# すべてのコマンドを表示
make help

📚 ドキュメント

AIアシスタントの設定

LinuxのClaude DesktopまたはCursorの場合

config.json ファイルに以下を追加します。

⚠️ Windowsユーザーへの重要な注意：Windowsを使用している場合は、このMCPサーバーを実行するにはWSL (Windows Subsystem for Linux) を使用する必要があります。

{
  "mcpServers": {
    "freepik-fastmcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory", 
        "/FULL/PATH/TO/freepik-mcp",
        "fastmcp",
        "run",
        "main.py"
      ],
      "env": {
        "FREEPIK_API_KEY": "your_actual_api_key_here"
      }
    }
  }
}

重要な設定手順

1. フルパスを見つける

   pwd
   # 出力をコピーし、config内の /FULL/PATH/TO/ を置き換える
   

2. APIキーを置き換える

   • freepik.com/api から取得します。
   • your_actual_api_key_here を置き換えます。

開発コマンド

🔧 技術詳細

コミット規約

このプロジェクトでは Conventional Commits を使用しています。コミットは以下の形式で行ってください。

<type>(<scope>): <description>

[optional body]

[optional footer(s)]

タイプ:

• feat: 新機能
• fix: バグ修正
• docs: ドキュメントの変更
• style: コードスタイルの変更（整形など）
• refactor: コードのリファクタリング
• test: テストの追加または更新
• chore: メンテナンスタスク

例:

feat(icons): add search filtering by category
fix(api): resolve authentication timeout issue  
docs(readme): update installation instructions
refactor(mystic): improve error handling logic

コントリビューションワークフロー

1. リポジトリをフォーク します。
2. 機能ブランチを作成 します: git checkout -b feat/amazing-feature
3. コンベンショナルな形式でコミット します: git commit -m "feat: add amazing feature"
4. ブランチにプッシュ します: git push origin feat/amazing-feature
5. プルリクエストを作成 します。

📄 APIドキュメント

詳細なAPI情報は、Freepik APIドキュメント を参照してください。

🆘 トラブルシューティング

一般的な問題と解決策

1. "Command not found" → uv 依存関係マネージャーをインストールしてください。
2. "Invalid API Key" → freepik.com/api でキーを確認してください。
3. "Path not found" → 設定ファイル内のフルパスを確認してください。
4. "Connection refused" → make dev でサーバーが実行されていることを確認してください。

問題が解決しない場合

GitHubで以下の情報を含めてイシューを作成してください。

• お使いのOSとPythonのバージョン
• 完全なエラーメッセージ
• 設定ファイル（APIキーを除く）

⚠️ 重要提示

APIキーをコミットしないでください。

💡 使用建议

機密データには .env ファイルを使用してください。.env ファイルは .gitignore に含まれています。

AIで素晴らしいコンテンツを作成する準備はできましたか？ 🎨✨