MCP Audio Inspector

Analiza archivos de audio y extrae metadatos, adaptado para flujos de trabajo de desarrollo de audio de juegos.

GitHubPrueba este MCPPatrocinado

Documentación

Inspector de Audio MCP

npm version npm downloads license

Un servidor Model Context Protocol (MCP) para el análisis integral de archivos de audio y extracción de metadatos, diseñado específicamente para flujos de trabajo de desarrollo de audio para videojuegos.

Características

  • Extracción integral de metadatos: Utiliza la biblioteca music-metadata para un análisis detallado del audio.
  • Respaldo con FFprobe: Maneja formatos exóticos y corruptos mediante FFprobe.
  • Análisis de audio para videojuegos: Análisis especializado para casos de uso en desarrollo de juegos.
  • Procesamiento por lotes: Analiza directorios completos de archivos de audio.
  • Integración MCP: Integración perfecta con Claude Desktop.
  • Multiplataforma: Funciona en Windows, macOS y Linux.

Instalación

npm install -g mcp-audio-inspector

O usa con npx:

npx mcp-audio-inspector

Uso

Modo servidor MCP (Claude Desktop)

Agrega a tu configuración de Claude Desktop:

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

Modo CLI independiente

Analiza un solo archivo:

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

Analiza por lotes un directorio:

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

Guarda la salida en un archivo:

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

Formatos compatibles

Compatibilidad principal (music-metadata):

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

Compatibilidad extendida (respaldo con FFprobe):

  • Cualquier formato compatible con FFmpeg

Herramientas MCP

analyze_audio_file

Analiza un solo archivo de audio y extrae metadatos completos.

Parámetros:

  • filePath (cadena, obligatorio): Ruta al archivo de audio.
  • includeGameAnalysis (booleano, opcional): Incluye análisis específico para videojuegos (predeterminado: true).

analyze_audio_batch

Analiza todos los archivos de audio en un directorio.

Parámetros:

  • directoryPath (cadena, obligatorio): Ruta al directorio que contiene los archivos de audio.
  • recursive (booleano, opcional): Busca subdirectorios de forma recursiva (predeterminado: false).
  • includeGameAnalysis (booleano, opcional): Incluye análisis específico para videojuegos (predeterminado: true).

get_supported_formats

Obtén la lista de formatos de audio compatibles.

Esquema de salida

La herramienta devuelve metadatos completos que incluyen:

{
  "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álisis de audio para videojuegos

El inspector incluye análisis especializado para desarrollo de juegos:

  • Idoneidad para bucles: Determina si el audio es adecuado para reproducirse en bucle.
  • Recomendaciones de compresión: Sugiere formatos de compresión óptimos.
  • Estimación del uso de memoria: Calcula los requisitos de memoria sin comprimir.
  • Optimizaciones de plataforma: Sugerencias de optimización específicas para cada plataforma.
  • Notas de desarrollo de juegos: Recomendaciones prácticas para el audio de videojuegos.

Requisitos

  • Node.js 18+
  • FFmpeg/FFprobe (para soporte de respaldo)

Documentación completa

Este README proporciona una descripción general rápida. Para documentación completa:

🚀 Comenzando

🎮 Flujos de trabajo y tutoriales

🔧 Soporte y solución de problemas

Licencia

Licencia MIT: consulta el archivo LICENCIA para obtener más detalles.

Contribuciones

¡Las contribuciones son bienvenidas! Lee nuestra Guía de contribución y envía solicitudes de incorporación de cambios a nuestro repositorio de GitHub.

Soporte