Freepik MCP 服务器
MCP 服务器实现用于与 Freepik 的 API 交互，提供对库存照片和 Mystic AI 图像生成功能的访问。
特征
- 搜索 Freepik 资源（照片、矢量图、PSD）
- 获取详细资源信息
- 下载资源
- 使用 Mystic AI 生成图像
- 检查图像生成状态
先决条件
- Node.js 18 或更高版本
- Freepik API 密钥（请参阅API 设置指南）
安装
# Create a new directory for your MCP servers
mkdir mcp-servers
cd mcp-servers
# Clone the repository
git clone https://github.com/MCERQUA/freepik-mcp.git
cd freepik-mcp
# Install dependencies
npm install
# Build the server
npm run build
配置
- 首先，按照API_SETUP.md中的说明获取您的 Freepik API 密钥
- 将服务器添加到您的 MCP 设置文件：
{
"mcpServers": {
"freepik": {
"command": "node",
"args": ["path/to/freepik-mcp/build/index.js"],
"env": {
"FREEPIK_API_KEY": "your-api-key-here"
},
"disabled": false,
"autoApprove": []
}
}
}
可用工具
搜索资源
使用各种过滤器搜索 Freepik 资源：
{
term?: string; // Search term
limit?: number; // Results per page
order?: 'relevance' | 'recent';
filters?: {
orientation?: {
landscape?: boolean;
portrait?: boolean;
square?: boolean;
panoramic?: boolean;
};
content_type?: {
photo?: boolean;
psd?: boolean;
vector?: boolean;
};
license?: {
freemium?: boolean;
premium?: boolean;
};
};
}
获取资源
获取有关特定资源的详细信息：
{
id: number; // Resource ID to get details for
}
下载资源
获取特定资源的下载URL：
{
id: number; // Resource ID to download
}
生成图像
使用 Freepik Mystic AI 生成图像：
{
prompt: string; // Text description of the image to generate
resolution?: '2k' | '4k';
aspect_ratio?: 'square_1_1' | 'classic_4_3' | 'traditional_3_4' |
'widescreen_16_9' | 'social_story_9_16';
realism?: boolean; // Enable realistic style
engine?: 'automatic' | 'magnific_illusio' | 'magnific_sharpy' | 'magnific_sparkle';
creative_detailing?: number; // 0-100
}
检查状态
检查 Mystic 图像生成任务的状态：
{
task_id: string; // ID of the generation task to check
}
发展
# Install dependencies
npm install
# Build the server
npm run build
# Run in development mode
npm run dev
错误处理
服务器实现了全面的错误处理：
- API 错误记录有详细信息
- 使用 Zod 模式进行输入验证
- 结合上下文的正确错误响应
- 速率限制意识
贡献
- 分叉存储库
- 创建你的功能分支（
git checkout -b feature/amazing-feature ） - 提交您的更改（
git commit -m 'Add some amazing feature' ） - 推送到分支（
git push origin feature/amazing-feature ） - 打开拉取请求
执照
麻省理工学院