MCP Audio Inspector

Analisa arquivos de áudio e extrai metadados, adaptado para fluxos de trabalho de desenvolvimento de áudio para jogos.

GitHubExperimente este MCPPatrocinado

Documentação

MCP Audio Inspector

npm version npm downloads license

Um servidor Model Context Protocol (MCP) para análise abrangente de arquivos de áudio e extração de metadados, projetado especificamente para fluxos de trabalho de desenvolvimento de áudio para jogos.

Recursos

  • Extração Abrangente de Metadados: Usa a biblioteca music-metadata para análise detalhada de áudio
  • Fallback com FFprobe: Lida com formatos exóticos e corrompidos por meio do FFprobe
  • Análise de Áudio para Jogos: Análise especializada para casos de uso de desenvolvimento de jogos
  • Processamento em Lote: Analise diretórios inteiros de arquivos de áudio
  • Integração MCP: Integração perfeita com o Claude Desktop
  • Multiplataforma: Funciona em Windows, macOS e Linux

Instalação

npm install -g mcp-audio-inspector

Ou use com npx:

npx mcp-audio-inspector

Uso

Modo Servidor MCP (Claude Desktop)

Adicione à sua configuração do Claude Desktop:

{
  "mcpServers": {
    "audio-inspector": {
      "command": "npx",
      "args": ["-y", "mcp-audio-inspector"],
      "env": {}
    }
  }
}

Modo CLI Autônomo

Analise um único arquivo:

npx mcp-audio-inspector --standalone path/to/audio.mp3

Analise um diretório em lote:

npx mcp-audio-inspector --batch path/to/audio/directory

Salve a saída em um arquivo:

npx mcp-audio-inspector --standalone audio.wav --output analysis.json

Formatos Suportados

Suporte Primário (music-metadata):

  • MP3, WAV, FLAC, OGG, M4A, AAC, WMA, AIFF, AU, WebM, Opus, APE, MP4

Suporte Estendido (fallback do FFprobe):

  • Qualquer formato suportado pelo FFmpeg

Ferramentas MCP

analyze_audio_file

Analise um único arquivo de áudio e extraia metadados abrangentes.

Parâmetros:

  • filePath (string, obrigatório): Caminho para o arquivo de áudio
  • includeGameAnalysis (booleano, opcional): Incluir análise específica para jogos (padrão: true)

analyze_audio_batch

Analise todos os arquivos de áudio em um diretório.

Parâmetros:

  • directoryPath (string, obrigatório): Caminho para o diretório que contém arquivos de áudio
  • recursive (booleano, opcional): Pesquisar subdiretórios recursivamente (padrão: false)
  • includeGameAnalysis (booleano, opcional): Incluir análise específica para jogos (padrão: true)

get_supported_formats

Obtenha a lista de formatos de áudio suportados.

Esquema de Saída

A ferramenta retorna metadados abrangentes, incluindo:

{
  "file": {
    "path": "string",
    "name": "string", 
    "size": "number",
    "modified": "ISO date string"
  },
  "format": {
    "container": "string",
    "codec": "string",
    "lossless": "boolean",
    "duration": "number",
    "bitrate": "number",
    "sampleRate": "number",
    "channels": "number",
    "bitsPerSample": "number"
  },
  "tags": {
    "title": "string",
    "artist": "string",
    "album": "string",
    "year": "number",
    "genre": "string",
    "track": "number",
    "comment": "string"
  },
  "gameAudio": {
    "suitableForLoop": "boolean",
    "recommendedCompressionFormat": "string",
    "estimatedMemoryUsage": "number",
    "platformOptimizations": {
      "mobile": "string",
      "desktop": "string", 
      "console": "string"
    },
    "compressionRatio": "number",
    "gameDevNotes": "string"
  }
}

Análise de Áudio para Jogos

O inspetor inclui análise especializada para desenvolvimento de jogos:

  • Adequação para Loop: Determina se o áudio é adequado para loop
  • Recomendações de Compressão: Sugere formatos de compressão ideais
  • Estimativa de Uso de Memória: Calcula os requisitos de memória não comprimida
  • Otimizações de Plataforma: Sugestões de otimização específicas da plataforma
  • Notas de Desenvolvimento de Jogos: Recomendações acionáveis para áudio de jogos

Requisitos

  • Node.js 18+
  • FFmpeg/FFprobe (para suporte de fallback)

Documentação Completa

Este README fornece uma visão geral rápida. Para documentação abrangente:

🚀 Primeiros Passos

🎮 Fluxos de Trabalho e Tutoriais

🔧 Suporte e Solução de Problemas

Licença

Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Contribuição

Contribuições são bem-vindas! Leia nosso Guia de Contribuição e envie pull requests para nosso repositório no GitHub.

Suporte