Skip to main content
Glama
MCERQUA

Freepik MCP Server

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)

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Related MCP Servers

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/MCERQUA/freepik-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server