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

Related MCP server: Meilisearch MCP Server

Prerrequisitos

Node.js 18 o superior
Una clave API de Freepik (consulte la Guía de configuración de API )

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)

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Freepik MCP Server