Skip to main content
Glama
README.md
# sfx_mcp_bbc — efeitos sonoros da BBC direto no Claude

Um **MCP** que deixa o Claude (ou qualquer app que fale MCP) **buscar, ouvir e baixar** efeitos sonoros do acervo
[BBC Sound Effects](https://sound-effects.bbcrewind.co.uk): são cerca de **33 mil sons** (portas, aplausos, chuva,
máquinas, natureza, multidão, transporte…).

Em vez de entrar no site e baixar um por um, você só pede:

> "Busque na BBC um aplauso curto, de até 8 segundos."
> "Baixe o 07017018 em WAV."

e o Claude faz a busca, mostra as opções com link para ouvir e salva o arquivo numa pasta do seu computador.

> **Projeto independente.** Não é oficial nem tem ligação com a BBC. Os sons são da BBC e têm licença própria:
> leia a seção [Licença dos sons](#licença-dos-sons-importante) antes de usar em qualquer vídeo.

---

## O que é um MCP?

MCP (Model Context Protocol) é um padrão aberto que funciona como uma **tomada universal** para o Claude: cada MCP
instalado dá ao Claude novos "botões" que ele sabe apertar sozinho. Este aqui dá dois botões:

| Ferramenta | O que faz |
|---|---|
| `bbc_buscar` | Busca sons por palavra (em inglês), com filtro de categoria e de duração. Devolve id, descrição, duração, link de **prévia em MP3**, página do som e link **comprar**. |
| `bbc_baixar` | Baixa **um** som pelo id, em **WAV** (arquivo original, 44,1 kHz) ou **MP3** (prévia leve), e anota o crédito num `CREDITOS.txt`. |

Como funciona por dentro:

```
Você ──pede──▶ Claude ──aperta o botão──▶ MCP sfx_mcp_bbc (no seu computador) ──▶ API da BBC (internet)
                                                     │
                                                     └──salva──▶ pasta bbc-sfx/ + CREDITOS.txt
```

---

## Requisitos

- **Node.js 18 ou mais novo**: baixe em [nodejs.org](https://nodejs.org) (versão LTS). Para conferir, abra o Terminal
  (no Windows, o "Prompt de Comando") e digite `node -v`.
- Um app compatível com MCP: **Claude Desktop**, **Claude Code** ou outro cliente MCP.

---

## Instalação

### Opção 1 — Claude Code (um comando)

No Terminal:

```bash
claude mcp add bbc-sfx --scope user -- npx -y github:leovieirafreitas/sfx_mcp_bbc
```

Pronto. Abra uma nova sessão do Claude Code e peça: *"busque na BBC o som de uma porta fechando"*.

Para escolher a pasta onde os sons vão ser salvos:

```bash
claude mcp add bbc-sfx --scope user -e BBC_SFX_DIR="/Users/seunome/Music/bbc-sfx" -- npx -y github:leovieirafreitas/sfx_mcp_bbc
```

### Opção 2 — Claude Desktop (o aplicativo)

1. Abra o Claude Desktop e vá em **Configurações → Desenvolvedor → Editar configuração**. Isso abre o arquivo
   `claude_desktop_config.json`:
   - **Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`
   - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
2. Cole isto (se o arquivo já tiver outros MCPs, adicione só o bloco `"bbc-sfx"` dentro de `"mcpServers"`):

   **Mac / Linux**
   ```json
   {
     "mcpServers": {
       "bbc-sfx": {
         "command": "npx",
         "args": ["-y", "github:leovieirafreitas/sfx_mcp_bbc"]
       }
     }
   }
   ```

   **Windows**
   ```json
   {
     "mcpServers": {
       "bbc-sfx": {
         "command": "cmd",
         "args": ["/c", "npx", "-y", "github:leovieirafreitas/sfx_mcp_bbc"]
       }
     }
   }
   ```
3. Salve, **feche o Claude Desktop por completo** e abra de novo. O MCP aparece na lista de ferramentas.

Para mudar a pasta dos downloads, acrescente dentro do bloco `"bbc-sfx"`:

```json
"env": { "BBC_SFX_DIR": "C:\\Users\\seunome\\Music\\bbc-sfx" }
```

### Opção 3 — Instalação manual (baixando o código)

```bash
git clone https://github.com/leovieirafreitas/sfx_mcp_bbc.git
cd sfx_mcp_bbc
npm install
npm test
```

Depois aponte o seu app para o arquivo `server.mjs`, com o caminho completo. No Claude Desktop:

```json
{
  "mcpServers": {
    "bbc-sfx": {
      "command": "node",
      "args": ["/caminho/completo/para/sfx_mcp_bbc/server.mjs"]
    }
  }
}
```

No Claude Code: `claude mcp add bbc-sfx --scope user -- node /caminho/completo/para/sfx_mcp_bbc/server.mjs`

---

## Como usar

Converse normalmente com o Claude. Exemplos:

- "Busque na BBC 5 sons de **chuva** com até 1 minuto."
- "Quero um **aplauso** de plateia pequena. Me mostra as opções."
- "Procura **porta de carro** na categoria Transport."
- "Baixa o 07027114 em **MP3** pra eu ouvir."
- "Baixa o 07017018 em **WAV**."

Dicas:
- As descrições dos sons estão **em inglês**: buscar *door*, *applause*, *rain*, *whoosh* dá muito mais resultado.
- Categorias disponíveis: Aircraft, Animals, Applause, Atmosphere, Bells, Birds, Clocks, Comedy, Crowds, Daily Life,
  Destruction, Electronics, Events, Fire, Footsteps, Industry, Machines, Medical, Military, Nature, Sport, Toys, Transport.
- Cada resultado traz um link de prévia em MP3: dá para ouvir antes de baixar.

### Onde os arquivos ficam

Por padrão em **`Downloads/bbc-sfx`** (dentro da sua pasta de usuário), ou na pasta definida em `BBC_SFX_DIR`. Cada som
é salvo como `bbc_<id>.wav` ou `bbc_<id>.mp3`, e o crédito vai para o `CREDITOS.txt` da mesma pasta.

### Usar pelo terminal (sem o Claude)

```bash
node cli.mjs bbc_buscar '{"query":"door","max_segundos":5}'
node cli.mjs bbc_baixar '{"id":"07027114","formato":"wav"}'
```

---

## Licença dos sons (importante)

Os sons são da BBC e seguem a licença **RemArc** ([leia aqui](https://sound-effects.bbcrewind.co.uk/licensing)).
Resumo, sem substituir o texto oficial:

**Pode, de graça:**
- uso **pessoal**, **pesquisa** e **ensino formal** (aluno ou professor de escola e faculdade);
- ouvir, testar e usar em projetos **não comerciais**.

**Não pode sem comprar ou pedir permissão:**
- **subir o som em redes sociais** (Instagram, TikTok, YouTube…): a licença proíbe expressamente;
- uso **comercial** (monetizar, vender, anúncio, patrocínio, trabalho para cliente);
- uso por **ONG, igreja ou órgão público**, e uso para **arrecadar doações** ou fazer campanha;
- usar os sons para **treinar inteligência artificial** ou fazer mineração de dados.

**Quer usar num vídeo ou projeto comercial?** Cada resultado tem o link **comprar**: ele abre o mesmo som na
[Pro Sound Effects](https://www.prosoundeffects.com), que faz o licenciamento comercial oficial dos sons da BBC.

**Crédito:** quando usar, coloque `bbc.co.uk – © copyright <ano> BBC` (o `CREDITOS.txt` já traz a linha pronta).

Por respeito ao acervo, o MCP baixa **um som por vez**: ele não serve para baixar o acervo inteiro.

---

## Perguntas frequentes

**O MCP não aparece no Claude.** Feche o app por completo (no Mac, `Cmd+Q`) e abra de novo. Confira se o JSON está
válido (vírgulas e chaves) e se o `node -v` funciona no Terminal.

**Erro "npx não encontrado".** Instale o Node.js em [nodejs.org](https://nodejs.org) e reinicie o computador. No Mac,
se você usa nvm, coloque o caminho completo do npx ou do node (descubra com `which npx`).

**Funciona no Windows?** Sim. Use o bloco de configuração do Windows (com `cmd /c`).

**Preciso de chave de API ou de conta?** Não.

**A busca voltou vazia.** Tente em inglês e com palavras mais simples (*door* em vez de *closing door sound*).

---

## Licença do código

Código sob licença **MIT** (veja [LICENSE](LICENSE)): use, modifique e compartilhe à vontade. A licença MIT vale só
para este código; os sons continuam com a licença da BBC.

Criado por **Leonardo Freitas**.

---

## English (short)

`sfx_mcp_bbc` is an unofficial MCP server to **search, preview and download** sound effects from the
[BBC Sound Effects](https://sound-effects.bbcrewind.co.uk) archive (~33k sounds) from Claude or any MCP client.

- Tools: `bbc_buscar` (search with category/duration filters, returns preview MP3 + Pro Sound Effects purchase link)
  and `bbc_baixar` (downloads one sound as WAV or MP3 and logs the credit in `CREDITOS.txt`).
- Install (Claude Code): `claude mcp add bbc-sfx --scope user -- npx -y github:leovieirafreitas/sfx_mcp_bbc`
- Download folder: `BBC_SFX_DIR` env var (default `~/Downloads/bbc-sfx`). Requires Node.js 18+.
- **Sound licence:** BBC RemArc licence, which covers personal, research and educational non-commercial use only. Uploading to social media,
  commercial use and use by non-profits require a licence: buy via [Pro Sound Effects](https://www.prosoundeffects.com)
  (link included in every result). Code: MIT.