Placid.app

Servidor MCP de Placid.app

Una implementación de servidor MCP para integrarse con la API de Placid.app. Este servidor proporciona herramientas para listar plantillas y generar imágenes y videos a través del Protocolo de Contexto de Modelos (MCP).

Características

• Lista plantillas disponibles de Placid con opciones de filtrado
• Genera imágenes y videos usando plantillas y contenido dinámico
• Gestión segura de tokens de API
• Manejo de errores y validación
• Implementación con seguridad de tipos

Requisitos: Node.js

1. Instala Node.js (versión 18 o superior) y npm desde nodejs.org
2. Verifica la instalación:

   node --version
   npm --version
   

Instalación

Inicio Rápido (Recomendado)

La forma más fácil de comenzar es usando Smithery, que configurará automáticamente todo por ti:

npx -y @smithery/cli install @felores/placid-mcp-server --client claude

Configuración Manual

Si prefieres configurar manualmente, agrega esto a la configuración de Claude Desktop o Cline:

{
  "mcpServers": {
    "placid": {
      "command": "npx",
      "args": ["@felores/placid-mcp-server"],
      "env": {
        "PLACID_API_TOKEN": "your-api-token"
      }
    }
  }
}

Cómo Obtener tu Token de API de Placid

1. Inicia sesión en tu cuenta de Placid.app
2. Ve a Configuración > API
3. Haz clic en "Crear Token de API"
4. Asigna un nombre a tu token (por ejemplo, "Servidor MCP")
5. Copia el token generado
6. Agrega el token a tu configuración como se muestra arriba

Desarrollo

# Run in development mode with hot reload
npm run dev

# Run tests
npm test

Herramientas

placid_list_templates

Lista las plantillas disponibles de Placid con opciones de filtrado. Cada plantilla incluye su título, ID, URL de imagen de vista previa, capas disponibles y etiquetas.

Parámetros

• collection_id (opcional): Filtra plantillas por ID de colección
• custom_data (opcional): Filtra por datos de referencia personalizados
• tags (opcional): Matriz de etiquetas para filtrar plantillas

Respuesta

Devuelve una matriz de plantillas, cada una con:

• uuid: Identificador único de la plantilla
• title: Nombre de la plantilla
• thumbnail: URL de imagen de vista previa (si está disponible)
• layers: Matriz de capas disponibles con sus nombres y tipos
• tags: Matriz de etiquetas de la plantilla

placid_generate_video

Genera videos combinando plantillas de Placid con contenido dinámico como videos, imágenes y texto. Para videos más largos (tiempo de procesamiento superior a 60 segundos), recibirás un ID de trabajo para verificar el estado en tu panel de Placid.

Parámetros

• template_id (obligatorio): UUID de la plantilla a utilizar
• layers (obligatorio): Objeto que contiene contenido dinámico para las capas de la plantilla
  • Para capas de video: { "layerName": { "video": "https://video-url.com" } }
  • Para capas de imagen: { "layerName": { "image": "https://image-url.com" } }
  • Para capas de texto: { "layerName": { "text": "Your content" } }
• audio (opcional): URL de un archivo de audio mp3
• audio_duration (opcional): Establecer en 'auto' para recortar el audio a la duración del video
• audio_trim_start (opcional): Marca de tiempo del punto de inicio del recorte (por ejemplo, '00:00:45' o '00:00:45.25')
• audio_trim_end (opcional): Marca de tiempo del punto final del recorte (por ejemplo, '00:00:55' o '00:00:55.25')

Respuesta

Devuelve un objeto que contiene:

• status: Estado actual ("finalizado", "en cola" o "error")
• video_url: URL para descargar el video generado (cuando el estado es "finalizado")
• job_id: ID para verificar el estado en el panel de Placid (para videos más largos)

Ejemplo de uso para modelos LLM

{
  "template_id": "template-uuid",
  "layers": {
    "MEDIA": { "video": "https://example.com/video.mp4" },
    "PHOTO": { "image": "https://example.com/photo.jpg" },
    "LOGO": { "image": "https://example.com/logo.png" },
    "HEADLINE": { "text": "My Video Title" }
  },
  "audio": "https://example.com/background.mp3",
  "audio_duration": "auto"
}

placid_generate_image

Genera imágenes estáticas combinando plantillas de Placid con contenido dinámico como texto e imágenes.

Parámetros

• template_id (obligatorio): UUID de la plantilla a utilizar
• layers (obligatorio): Objeto que contiene contenido dinámico para las capas de la plantilla
  • Para capas de texto: { "layerName": { "text": "Your content" } }
  • Para capas de imagen: { "layerName": { "image": "https://image-url.com" } }

Respuesta

Devuelve un objeto que contiene:

• status: "finalizado" cuando se completa
• image_url: URL para descargar la imagen generada

Ejemplo de uso para modelos LLM

{
  "template_id": "template-uuid",
  "layers": {
    "headline": { "text": "Welcome to My App" },
    "background": { "image": "https://example.com/bg.jpg" }
  }
}

Documentación

Para obtener información más detallada sobre la API de Placid, visita la Documentación de la API de Placid.

Licencia

MIT