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配置
- 首先，按照中的说明获取Freepik API密钥 API_SETUP.md
- 将服务器添加到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
}generate_image
使用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
}check_status
检查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) - 打开拉取请求
许可证
麻省理工学院
