MCP Media Processing Server

MCP Media Processing Server

Um servidor Node.js que implementa o Model Context Protocol (MCP) para operações de processamento de mídia, fornecendo poderosas capacidades de manipulação de vídeo e imagem.

Recursos

• Processamento e conversão de vídeo
• Processamento e manipulação de imagem
• Compressão de mídia
• Corte e edição de vídeo
• Efeitos de imagem e marca d'água

Pré-requisitos

Antes de usar este servidor, certifique-se de ter as seguintes dependências instaladas no seu sistema:

• FFmpeg: Necessário para operações de processamento de vídeo

  • macOS: brew install ffmpeg
  • Ubuntu/Debian: sudo apt-get install ffmpeg
  • Windows: Baixe do site oficial do FFmpeg

• ImageMagick: Necessário para operações de processamento de imagem

  • macOS: brew install imagemagick
  • Ubuntu/Debian: sudo apt-get install imagemagick
  • Windows: Baixe do site oficial do ImageMagick

Como usar

Adicione isto ao seu claude_desktop_config.json:

NPX

{
  "mcpServers": {
    "mediaProcessor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-media-processor@latest"
      ]
    }
  }
}

API

Ferramentas

Operações de Vídeo

• execute-ffmpeg

  • Execute qualquer comando FFmpeg com opções personalizadas
  • Entradas:
    • inputPath (string): Caminho absoluto para o arquivo de vídeo de entrada
    • options (string[]): Matriz de opções de comando do FFmpeg
    • outputPath (string, opcional): Caminho absoluto para o arquivo de saída
    • outputFilename (string, opcional): Nome do arquivo de saída

• convert-video

  • Converter vídeo para um formato diferente
  • Entradas:
    • inputPath (string): Caminho absoluto para o arquivo de vídeo de entrada
    • outputFormat (string): Formato de saída desejado (ex.: mp4, mkv, avi)
    • outputPath (string, opcional): Caminho de saída personalizado
    • outputFilename (string, opcional): Nome do arquivo de saída personalizado

• compress-video

  • Comprimir arquivo de vídeo
  • Entradas:
    • inputPath (string): Caminho absoluto para o arquivo de vídeo de entrada
    • quality (number, opcional): Qualidade de compressão (1-51, menor é melhor qualidade)
    • outputPath (string, opcional): Caminho de saída personalizado
    • outputFilename (string, opcional): Nome do arquivo de saída personalizado

• trim-video

  • Cortar vídeo para uma duração especificada
  • Entradas:
    • inputPath (string): Caminho absoluto para o arquivo de vídeo de entrada
    • startTime (string): Tempo de início no formato HH:MM:SS
    • duration (string): Duração no formato HH:MM:SS
    • outputPath (string, opcional): Caminho de saída personalizado
    • outputFilename (string, opcional): Nome do arquivo de saída personalizado

Operações de Imagem

• compress-image

  • Comprimir imagem PNG usando ImageMagick
  • Entradas:
    • inputPath (string): Caminho absoluto para a imagem PNG de entrada
    • quality (number, opcional): Qualidade de compressão (1-100)
    • outputPath (string, opcional): Caminho de saída personalizado
    • outputFilename (string, opcional): Nome do arquivo de saída personalizado

• convert-image

  • Converter imagem para um formato diferente
  • Entradas:
    • inputPath (string): Caminho absoluto para o arquivo de imagem de entrada
    • outputFormat (string): Formato de saída desejado (ex.: jpg, png, webp, gif)
    • outputPath (string, opcional): Caminho de saída personalizado
    • outputFilename (string, opcional): Nome do arquivo de saída personalizado

• resize-image

  • Redimensionar imagem para dimensões especificadas
  • Entradas:
    • inputPath (string): Caminho absoluto para o arquivo de imagem de entrada
    • width (number, opcional): Largura alvo em pixels
    • height (number, opcional): Altura alvo em pixels
    • maintainAspectRatio (boolean, opcional): Se deve manter a proporção
    • outputPath (string, opcional): Caminho de saída personalizado
    • outputFilename (string, opcional): Nome do arquivo de saída personalizado

• rotate-image

  • Girar imagem por graus especificados
  • Entradas:
    • inputPath (string): Caminho absoluto para o arquivo de imagem de entrada
    • degrees (number): Ângulo de rotação em graus
    • outputPath (string, opcional): Caminho de saída personalizado
    • outputFilename (string, opcional): Nome do arquivo de saída personalizado

• add-watermark

  • Adicionar marca d'água à imagem
  • Entradas:
    • inputPath (string): Caminho absoluto para o arquivo de imagem de entrada
    • watermarkPath (string): Caminho absoluto para o arquivo de imagem da marca d'água
    • position (string, opcional): Posição da marca d'água (padrão: "southeast")
    • opacity (number, opcional): Opacidade da marca d'água (0-100)
    • outputPath (string, opcional): Caminho de saída personalizado
    • outputFilename (string, opcional): Nome do arquivo de saída personalizado

• apply-effect

  • Aplicar efeito visual à imagem
  • Entradas:
    • inputPath (string): Caminho absoluto para o arquivo de imagem de entrada
    • effect (string): Efeito a aplicar (blur, sharpen, edge, emboss, grayscale, sepia, negate)
    • intensity (number, opcional): Intensidade do efeito (0-100)
    • outputPath (string, opcional): Caminho de saída personalizado
    • outputFilename (string, opcional): Nome do arquivo de saída personalizado

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.