sfx_mcp_bbc
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.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues