🚀 Freepik MCP 服务器
这是一个用于与 Freepik.com API 交互的 MCP（模型上下文协议）服务器，能够实现高级图片搜索、矢量图形搜索等功能，还支持错误处理和日志记录，并且具备自动化测试和 GitHub Actions CI/CD 能力。
🚀 快速开始
先决条件
- Python 3.10 或更高版本
- Freepik API 密钥
安装
- 克隆此仓库
- 安装依赖项：
pip install -e .
配置
- 从 Freepik 获取 API 密钥
- 设置环境变量：
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。