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)

Freepik MCP Server