freesound-mcp

Un servidor del Protocolo de Contexto de Modelo (MCP) que permite a las aplicaciones de IA buscar y descargar recursos de audio de la plataforma Freesound mediante comandos en lenguaje natural.

GitHub
1
Prueba este MCPPatrocinado

Documentación

Freesound-MCP

MCP Badge

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a las aplicaciones de IA buscar y descargar recursos de audio de la plataforma Freesound mediante comandos en lenguaje natural.

Descripción general

Freesound-MCP está diseñado para simplificar la integración de recursos de sonido libres de derechos en herramientas de IA. Sigue el estándar del Protocolo de Contexto de Modelo y se comunica con las aplicaciones anfitrionas a través de stdin/stdout. El servidor proporciona dos capacidades principales:

  • 🔍 Buscar sonidos: Busca sonidos por palabras clave con filtros opcionales para duración máxima y tipo de licencia
  • ⬇️ Descargar sonidos: Descarga archivos de audio por ID de sonido desde Freesound
  • 🎵 Soporte de metadatos: Recupera información detallada sobre los sonidos, incluyendo duración, licencia y enlaces de vista previa

Características

  • Servidor MCP ligero construido con Node.js
  • Mecanismo de comunicación estándar de entrada/salida compatible con el protocolo MCP
  • Gestión segura de claves API mediante variables de entorno
  • No requiere base de datos: diseño simple y sin estado

Requisitos previos

  • Node.js (compatible con módulos CommonJS)
  • Gestor de paquetes npm o yarn
  • Una clave API de Freesound (obtén una en la página de API de Freesound)

Instalación

  1. Clona el repositorio:
git clone https://github.com/yourusername/freesound-mcp.git
cd freesound-mcp
  1. Instala las dependencias:
npm install
  1. Compila el proyecto:
npm run build

Configuración

  1. Obtén tu clave API de Freesound desde la página de API de Freesound

  2. Establece tu clave API como variable de entorno:

export FREESOUND_API_KEY=your_freesound_api_key_here

Configuración en Claude Desktop

Para configurar este servidor MCP en Claude Desktop:

  1. Abre las preferencias de Claude Desktop
  2. Navega a "Funciones Beta" → "Herramientas del Protocolo de Contexto de Modelo (MCP)"
  3. Haz clic en "Configurar" para gestionar los servidores MCP
  4. Añade una nueva configuración de servidor con estos detalles:
    • Nombre: "Freesound MCP"
    • Comando: node
    • Argumentos: /path/to/freesound-mcp/dist/index.js (después de ejecutar npm run build)
    • Variables de entorno: Asegúrate de que FREESOUND_API_KEY esté disponible para el proceso
  5. Guarda la configuración y reinicia Claude

Después de reiniciar Claude, podrás usar las herramientas de Freesound en tus conversaciones.

Uso

Una vez configurado en Claude, puedes usar comandos en lenguaje natural como:

  • "Encuéntrame un sonido ambiental de selva tropical de menos de 30 segundos"
  • "Descarga el sonido #123456 en alta calidad"

Herramientas disponibles

1. Búsqueda en Freesound (freesound_search)

Busca sonidos en Freesound proporcionando palabras clave y filtros opcionales.

Parámetros:

  • query (obligatorio): Palabras clave de búsqueda
  • maxDuration (opcional): Duración máxima de los sonidos en segundos
  • license (opcional): Tipo de licencia de los sonidos a buscar

Devuelve:

  • Matriz de objetos de sonido que contienen:
    • id: ID del sonido
    • name: Nombre del sonido
    • duration: Duración del sonido en segundos
    • license: Licencia del sonido
    • preview: URL de vista previa del sonido

2. Descarga de Freesound (freesound_download)

Descarga un sonido de Freesound por ID de sonido.

Parámetros:

  • soundId (obligatorio): ID del sonido a descargar
  • quality (opcional): Calidad de audio ('hq' para alta calidad o 'lq' para baja calidad), por defecto 'lq'
  • downloadDir (opcional): Directorio de descarga personalizado, por defecto ~/.freesound-mcp/downloads

Devuelve:

  • filePath: Ruta donde se descargó el archivo

Consideraciones de seguridad

  • Mantén tu FREESOUND_API_KEY en secreto y nunca lo expongas en código del lado del cliente
  • Los parámetros de entrada se validan para evitar que se pasen IDs maliciosos a la API
  • El servidor sigue las mejores prácticas de seguridad de MCP para la comunicación

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción (Pull Request). Para cambios importantes, abre primero un issue para discutir lo que te gustaría cambiar.

Licencia

Este proyecto está licenciado bajo la Licencia MIT: consulta el archivo LICENCIA para más detalles.

Agradecimientos