Freepik MCP Server

🚀 Freepik MCP 服務器

這是一個用於與 Freepik.com API 交互的 MCP（模型上下文協議）服務器，能夠實現高級圖片搜索、矢量圖形搜索等功能，還支持錯誤處理和日誌記錄，並且具備自動化測試和 GitHub Actions CI/CD 能力。

🚀 快速開始

先決條件

• Python 3.10 或更高版本
• Freepik API 密鑰

安裝

1. 克隆此倉庫
2. 安裝依賴項：

pip install -e .

配置

1. 從 Freepik 獲取 API 密鑰
2. 設置環境變量：

export FREEPIK_API_KEY="your_api_key"

啟動服務器

啟動 MCP 服務器：

python -m freepik_mcp_server.server

✨ 主要特性

• 高級圖片搜索功能，帶過濾器
• 矢量圖形搜索
• 獲取特定圖片詳細信息
• 錯誤處理和日誌記錄
• 自動化測試
• GitHub Actions CI/CD

💻 使用示例

基礎用法

該服務器提供以下工具：

search_images

在 Freepik 上搜索圖片。

參數：

• query（必需）：搜索詞
• page：頁碼（默認：1）
• limit：每頁結果數（默認：20，最大：100）
• orientation：圖片方向（landscape, portrait, square）
• color：主要顏色過濾器

get_image_details

獲取特定圖片的詳細信息。

參數：

• id（必需）：Freepik 圖片 ID

search_vectors

在 Freepik 上搜索矢量圖形。

參數：

• query（必需）：搜索詞
• page：頁碼（默認：1）
• limit：每頁結果數（默認：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"
      }
    }
  }
}

🔧 技術細節

開發安裝

pip install -e ".[dev]"

運行測試

pytest

格式檢查

flake8 src tests

項目結構

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

📄 許可證

此項目由 MIT 許可證授權。

⚠️ 重要提示

• Freepik API 請求次數取決於您的訂閱計劃，某些功能需要 premium 賬戶。
• 請遵守 Freepik 的使用條款和服務協議。

💡 使用建議

歡迎貢獻！有關如何為項目做貢獻的詳細信息，請參閱 CONTRIBUTING.md。