Freepik MCP Server

🚀 Freepik MCP サーバ

Freepik MCP サーバは、Freepik.com API とのやり取りを行うための MCP（モデルコンテキストプロトコル）サーバです。このサーバを使用することで、Freepik 上の画像やベクターグラフィックを検索し、詳細情報を取得できます。

フランス語版

🚀 クイックスタート

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

前提条件

• Python 3.10 以上
• Freepik API キー

インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

pip install -e .

設定

1. Freepik から API キーを取得します。
2. 環境変数を設定します。

export FREEPIK_API_KEY="your_api_key"

サーバの起動

python -m freepik_mcp_server.server

✨ 主な機能

• 高度な画像検索機能（フィルタ付き）
• ベクターグラフィックの検索
• 特定の画像の詳細情報の取得
• エラー処理とログ記録
• 自動化テスト
• GitHub Actions による CI/CD

📦 インストール

クローン

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

依存関係のインストール

pip install -e .

💻 使用例

開発用インストール

pip install -e ".[dev]"

テストの実行

pytest

コードフォーマットのチェック

flake8 src tests

画像検索

# サーバを起動した後、以下のように API を呼び出すことができます。
# search_images エンドポイントを使用して、特定のキーワードで画像を検索します。
# ここでは、"nature" というキーワードで検索し、1 ページ目の結果を取得します。
curl -X POST -H "Content-Type: application/json" -d '{"query": "nature", "page": 1}' http://localhost:5000/search_images

画像詳細情報の取得

# get_image_details エンドポイントを使用して、特定の画像の詳細情報を取得します。
# ここでは、画像 ID が 12345 の画像の詳細情報を取得します。
curl -X POST -H "Content-Type: application/json" -d '{"id": 12345}' http://localhost:5000/get_image_details

ベクターグラフィックの検索

# search_vectors エンドポイントを使用して、特定のキーワードでベクターグラフィックを検索します。
# ここでは、"logo" というキーワードで検索し、1 ページ目の結果を取得します。
curl -X POST -H "Content-Type: application/json" -d '{"query": "logo", "page": 1}' http://localhost:5000/search_vectors

📚 ドキュメント

サーバが提供するツール

search_images

Freepik 上で画像を検索します。

パラメータ

• query（必須）: 検索キーワード
• page: ページ番号（デフォルト: 1）
• limit: 1 ページあたりの結果数（デフォルト: 20、最大: 100）
• orientation: 画像の向き（landscape, portrait, square）
• color: 主要な色フィルタ

get_image_details

特定の画像の詳細情報を取得します。

パラメータ

• id（必須）: Freepik の画像 ID

search_vectors

Freepik 上でベクターグラフィックを検索します。

パラメータ

• query（必須）: 検索キーワード
• page: ページ番号（デフォルト: 1）
• limit: 1 ページあたりの結果数（デフォルト: 20、最大: 100）
• orientation: ベクターの向き（landscape, portrait, square）

Claude Desktop との統合

Claude Desktop の設定ファイルに以下の設定を追加します。

{
  "mcpServers": {
    "freepik": {
      "command": "python",
      "args": ["-m", "freepik_mcp_server.server"],
      "env": {
        "FREEPIK_API_KEY": "your_api_key"
      }
    }
  }
}

🔧 技術詳細

プロジェクト構造

freepik-mcp-server/
├── src/
│   └── freepik_mcp_server/
│       ├── __init__.py
│       └── server.py
├── tests/
│   └── test_server.py
├── .github/
│   └── workflows/
│       └── python-package.yml
├── .gitignore
├── LICENSE
├── README.md
├── README_FR.md
├── pyproject.toml
└── requirements.txt

Freepik API の制限

• リクエスト数は、あなたのサブスクリプションプランに依存します。
• 一部の機能にはプレミアムアカウントが必要です。
• 注意事項: Freepik の利用規約とサービス契約に従ってください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。

貢献ガイド

貢献を歓迎します！このプロジェクトに貢献する方法の詳細については、CONTRIBUTING.md を参照してください。