Placid.app

Gere imagens e vídeos a partir de modelos usando a API do Placid.app.

Documentação

Servidor MCP Placid.app

Uma implementação de servidor MCP para integração com a API da Placid.app. Este servidor fornece ferramentas para listar templates e gerar imagens e vídeos através do Model Context Protocol.

Recursos

Lista templates disponíveis da Placid com opções de filtro
Gera imagens e vídeos usando templates e conteúdo dinâmico
Gerenciamento seguro de tokens de API
Tratamento de erros e validação
Implementação type-safe

Requisitos: Node.js

Instale o Node.js (versão 18 ou superior) e npm a partir de nodejs.org
Verifique a instalação:
```
node --version
npm --version
```

Instalação

Início Rápido (Recomendado)

A maneira mais fácil de começar é usando o Smithery, que configurará tudo automaticamente para você:

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

Configuração Manual

Se preferir configurar manualmente, adicione isto às configurações do seu Claude Desktop ou Cline:

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

Obtendo seu Token de API da Placid

Faça login na sua conta Placid.app
Vá para Configurações > API
Clique em "Criar Token de API"
Dê um nome ao seu token (ex.: "Servidor MCP")
Copie o token gerado
Adicione o token à sua configuração conforme mostrado acima

Desenvolvimento

# Run in development mode with hot reload
npm run dev

# Run tests
npm test

Ferramentas

placid_list_templates

Lista templates disponíveis da Placid com opções de filtro. Cada template inclui seu título, ID, URL da imagem de pré-visualização, camadas disponíveis e tags.

Parâmetros

collection_id (opcional): Filtra templates por ID de coleção
custom_data (opcional): Filtra por dados de referência personalizados
tags (opcional): Matriz de tags para filtrar templates

Resposta

Retorna uma matriz de templates, cada um contendo:

uuid: Identificador único do template
title: Nome do template
thumbnail: URL da imagem de pré-visualização (se disponível)
layers: Matriz de camadas disponíveis com seus nomes e tipos
tags: Matriz de tags do template

placid_generate_video

Gera vídeos combinando templates da Placid com conteúdo dinâmico como vídeos, imagens e texto. Para vídeos mais longos (tempo de processamento >60 segundos), você receberá um ID de trabalho para verificar o status no seu painel da Placid.

Parâmetros

template_id (obrigatório): UUID do template a ser usado
layers (obrigatório): Objeto contendo conteúdo dinâmico para as camadas do template
- Para camadas de vídeo: { "layerName": { "video": "https://video-url.com" } }
- Para camadas de imagem: { "layerName": { "image": "https://image-url.com" } }
- Para camadas de texto: { "layerName": { "text": "Your content" } }
audio (opcional): URL para um arquivo de áudio mp3
audio_duration (opcional): Defina como 'auto' para cortar o áudio conforme a duração do vídeo
audio_trim_start (opcional): Timestamp do ponto de início do corte (ex.: '00:00:45' ou '00:00:45.25')
audio_trim_end (opcional): Timestamp do ponto de fim do corte (ex.: '00:00:55' ou '00:00:55.25')

Resposta

Retorna um objeto contendo:

status: Status atual ("finished", "queued" ou "error")
video_url: URL para baixar o vídeo gerado (quando o status for "finished")
job_id: ID para verificar o status no painel da Placid (para vídeos mais longos)

Exemplo 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

Gera imagens estáticas combinando templates da Placid com conteúdo dinâmico como texto e imagens.

Parâmetros

template_id (obrigatório): UUID do template a ser usado
layers (obrigatório): Objeto contendo conteúdo dinâmico para as camadas do template
- Para camadas de texto: { "layerName": { "text": "Your content" } }
- Para camadas de imagem: { "layerName": { "image": "https://image-url.com" } }

Resposta

Retorna um objeto contendo:

status: "finished" quando concluído
image_url: URL para baixar a imagem gerada

Exemplo de Uso para Modelos LLM

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

Documentação

Para informações mais detalhadas sobre a API da Placid, visite a Documentação da API Placid.

Licença

MIT