Servidor MCP de Placid.app

Implementación de un servidor MCP para la integración con la API de Placid.app. Este servidor proporciona herramientas para listar plantillas y generar imágenes y vídeos mediante el Protocolo de Contexto de Modelo.

Características

• Lista de plantillas de Placid disponibles con opciones de filtrado
• Genera imágenes y vídeos usando plantillas y contenido dinámico
• Gestión segura de tokens API
• Manejo de errores y validación
• Implementación de tipo seguro

Requisitos: Node.js

1. Instale Node.js (versión 18 o superior) y npm desde nodejs.org
2. Verificar la instalación:
   node --version npm --version

Instalación

Inicio rápido (recomendado)

La forma más sencilla de comenzar es usar Smithery, que configurará todo automáticamente para usted:

Configuración manual

Si prefiere configurarlo manualmente, agregue esto a su configuración de Claude Desktop o Cline:

Cómo obtener su token API de Placid

1. Inicie sesión en su cuenta de Placid.app
2. Vaya a Configuración > API
3. Haga clic en "Crear token de API"
4. Dale un nombre a tu token (por ejemplo, "Servidor MCP")
5. Copiar el token generado
6. Agregue el token a su configuración como se muestra arriba

Desarrollo

Herramientas

plantillas de lista plácida

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

Parámetros

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

Respuesta

Devuelve una matriz de plantillas, cada una de las cuales contiene:

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

plácido_generar_video

Genera videos combinando plantillas de Placid con contenido dinámico como videos, imágenes y texto. Para videos más largos (más de 60 segundos de tiempo de procesamiento), recibirás un ID de trabajo para consultar 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 capas de plantilla
  • Para capas de vídeo: { "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 a un archivo de audio mp3
• audio_duration (opcional): Establézcalo en 'automático' 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 ("terminado", "en cola" o "error")
• video_url : URL para descargar el vídeo generado (cuando el estado es "terminado")
• job_id : ID para verificar el estado en el panel de Placid (para videos más largos)

Ejemplo de uso para modelos LLM

imagen generada plácida

Genere imágenes estáticas combinando plantillas 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 capas de 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 : "terminado" cuando esté completo
• image_url : URL para descargar la imagen generada

Ejemplo de uso para modelos LLM

Documentación

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

Licencia

Instituto Tecnológico de Massachusetts (MIT)