freesound-mcp

Um servidor Model Context Protocol (MCP) que permite que aplicações de IA pesquisem e baixem recursos de áudio da plataforma Freesound por meio de comandos em linguagem natural.

GitHub
1
Experimente este MCPPatrocinado

Documentação

Freesound-MCP

MCP Badge

Um servidor Model Context Protocol (MCP) que permite que aplicações de IA pesquisem e baixem recursos de áudio da plataforma Freesound por meio de comandos em linguagem natural.

Visão Geral

O Freesound-MCP foi projetado para simplificar a integração de recursos sonoros livres de direitos autorais em ferramentas de IA. Ele segue o padrão Model Context Protocol e se comunica com aplicações host via stdin/stdout. O servidor oferece duas capacidades principais:

  • 🔍 Pesquisar Sons: Pesquise sons por palavras-chave com filtros opcionais para duração máxima e tipo de licença
  • ⬇️ Baixar Sons: Baixe arquivos de áudio por ID do som no Freesound
  • 🎵 Suporte a Metadados: Recupere informações detalhadas sobre sons, incluindo duração, licença e links de pré-visualização

Recursos

  • Servidor MCP leve construído com Node.js
  • Mecanismo de comunicação padrão de entrada/saída compatível com o protocolo MCP
  • Gerenciamento seguro de chaves de API por meio de variáveis de ambiente
  • Sem necessidade de banco de dados - design simples e sem estado

Pré-requisitos

  • Node.js (com suporte a módulos CommonJS)
  • Gerenciador de pacotes npm ou yarn
  • Uma chave de API do Freesound (obtenha uma na página da API do Freesound)

Instalação

  1. Clone o repositório:
git clone https://github.com/yourusername/freesound-mcp.git
cd freesound-mcp
  1. Instale as dependências:
npm install
  1. Compile o projeto:
npm run build

Configuração

  1. Obtenha sua chave de API do Freesound na página da API do Freesound

  2. Defina sua chave de API como uma variável de ambiente:

export FREESOUND_API_KEY=your_freesound_api_key_here

Configuração no Claude Desktop

Para configurar este servidor MCP no Claude Desktop:

  1. Abra as preferências do Claude Desktop
  2. Navegue até "Recursos Beta" → "Ferramentas Model Context Protocol (MCP)"
  3. Clique em "Configurar" para gerenciar os servidores MCP
  4. Adicione uma nova configuração de servidor com estes detalhes:
    • Nome: "Freesound MCP"
    • Comando: node
    • Argumentos: /path/to/freesound-mcp/dist/index.js (após executar npm run build)
    • Variáveis de Ambiente: Garanta que FREESOUND_API_KEY esteja disponível para o processo
  5. Salve a configuração e reinicie o Claude

Após reiniciar o Claude, você poderá usar as ferramentas do Freesound em suas conversas.

Uso

Uma vez configurado no Claude, você pode usar comandos em linguagem natural, como:

  • "Encontre um som ambiente de floresta tropical com menos de 30 segundos"
  • "Baixe o som #123456 em alta qualidade"

Ferramentas Disponíveis

1. Pesquisa Freesound (freesound_search)

Pesquise sons no Freesound fornecendo palavras-chave e filtros opcionais.

Parâmetros:

  • query (obrigatório): Palavras-chave de pesquisa
  • maxDuration (opcional): Duração máxima dos sons em segundos
  • license (opcional): Tipo de licença dos sons a pesquisar

Retorna:

  • Matriz de objetos de som contendo:
    • id: ID do som
    • name: Nome do som
    • duration: Duração do som em segundos
    • license: Licença do som
    • preview: URL de pré-visualização do som

2. Download Freesound (freesound_download)

Baixe um som do Freesound pelo ID do som.

Parâmetros:

  • soundId (obrigatório): ID do som a ser baixado
  • quality (opcional): Qualidade de áudio ('hq' para alta qualidade ou 'lq' para baixa qualidade), padrão é 'lq'
  • downloadDir (opcional): Diretório de download personalizado, padrão é ~/.freesound-mcp/downloads

Retorna:

  • filePath: Caminho onde o arquivo foi baixado

Considerações de Segurança

  • Mantenha seu FREESOUND_API_KEY em segredo e nunca o exponha em código do lado do cliente
  • Os parâmetros de entrada são validados para evitar que IDs maliciosos sejam passados para a API
  • O servidor segue as melhores práticas de segurança do MCP para comunicação

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request. Para mudanças significativas, abra primeiro uma issue para discutir o que você gostaria de alterar.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

Agradecimentos