Servidor MCP de Freepik
Una implementación de servidor MCP para interactuar con la API de Freepik, brindando acceso a fotografías de archivo y capacidades de generación de imágenes de Mystic AI.
Características
- Buscar recursos de Freepik (fotos, vectores, PSD)
- Obtenga información detallada sobre los recursos
- Descargar recursos
- Generar imágenes usando Mystic AI
- Comprobar el estado de generación de imágenes
Prerrequisitos
Instalación
# 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
Configuración
- Primero, obtenga su clave API de Freepik siguiendo las instrucciones en API_SETUP.md
- Agregue el servidor a su archivo de configuración MCP:
{
"mcpServers": {
"freepik": {
"command": "node",
"args": ["path/to/freepik-mcp/build/index.js"],
"env": {
"FREEPIK_API_KEY": "your-api-key-here"
},
"disabled": false,
"autoApprove": []
}
}
}
Herramientas disponibles
recursos de búsqueda
Busca recursos de Freepik con varios filtros:
{
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;
};
};
}
obtener_recurso
Obtenga información detallada sobre un recurso específico:
{
id: number; // Resource ID to get details for
}
recurso de descarga
Obtener la URL de descarga para un recurso específico:
{
id: number; // Resource ID to download
}
generar_imagen
Generar una imagen usando 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
}
comprobar_estado
Comprobar el estado de una tarea de generación de imágenes de Mystic:
{
task_id: string; // ID of the generation task to check
}
Desarrollo
# Install dependencies
npm install
# Build the server
npm run build
# Run in development mode
npm run dev
Manejo de errores
El servidor implementa un manejo integral de errores:
- Los errores de API se registran con información detallada
- Validación de entrada mediante esquemas Zod
- Respuestas de error adecuadas con contexto
- Conciencia de limitación de velocidad
Contribuyendo
- Bifurcar el repositorio
- Crea tu rama de funciones (
git checkout -b feature/amazing-feature ) - Confirme sus cambios (
git commit -m 'Add some amazing feature' ) - Empujar a la rama (
git push origin feature/amazing-feature ) - Abrir una solicitud de extracción
Licencia
Instituto Tecnológico de Massachusetts (MIT)