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。