Skip to main content
Glama
enesjakozh
MCERQUA

Freepik MCP Server

by MCERQUA
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

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: Freepik FastMCP Toolkit

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

  1. Primero, obtenga su clave API de Freepik siguiendo las instrucciones en API_SETUP.md

  2. 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

  1. Bifurcar el repositorio

  2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

  3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

  4. Empujar a la rama ( git push origin feature/amazing-feature )

  5. Abrir una solicitud de extracción

Licencia

Instituto Tecnológico de Massachusetts (MIT)

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers