„Audio MCP“ serverio dokumentacija

Apžvalga

Serveris naudoja Model Context Protocol per Streamable HTTP. Nukreipkite bet kurį MCP klientą į žemiau nurodytą galinį tašką ir autentiškumą patvirtinkite naudodami „VocalRemover“ API žetoną. Failai perduodami kaip vieši http(s) URL adresai (iki 100 MB), o rezultatai grąžinami kaip atsisiunčiamų failų URL adresai.

Endpoint:  https://vocalremover.com/mcp/audio
Transport: Streamable HTTP (POST)
Auth:      Authorization: Bearer YOUR_API_TOKEN

Pradžios vadovas

1. Gaukite nemokamą API raktą svetainėje API puslapis.
2. Pridėkite serverį prie savo kliento naudodami žemiau pateiktą kodą.
3. Paprašykite: „Pašalinkite vokalą iš .“

Autentifikavimas

1. Susikurkite nemokamą paskyrą ir atidarykite API puslapis.
2. Sukurkite API raktą.
3. Įtraukite jį kaip „Bearer“ žetoną į savo MCP kliento konfigūraciją (žr. toliau).

Šį žetoną naudoja tiek nemokamos garso įrankiai, tiek mokami AI įrankiai; skirtumas yra tik tas, ar skaičiuojami konversijos minučių kreditai.

Kliento nustatymas

Pridėkite serverį prie savo AI kliento. „Claude Desktop“ naudoja „mcp-remote“ tiltą; „Cursor“, „Windsurf“, „Cline“, „Zed“ ir „Claude Code“ iš esmės palaiko nuotolinį MCP su „Bearer“ žetonu; „ChatGPT“ ir „Claude.ai“ internetinė programa jį prideda kaip pasirinktinį jungiklį ir prisijungia per OAuth (žr. toliau).

{
  "mcpServers": {
    "vocalremover": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://vocalremover.com/mcp/audio",
        "--header", "Authorization:${AUTH}"
      ],
      "env": { "AUTH": "Bearer YOUR_API_TOKEN" }
    }
  }
}

{
  "mcpServers": {
    "vocalremover": {
      "url": "https://vocalremover.com/mcp/audio",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

claude mcp add --transport http \
  vocalremover https://vocalremover.com/mcp/audio \
  -H "Authorization: Bearer YOUR_API_TOKEN"

„Anthropic Messages API“ (sukurkite savo agentą)

Prijunkite serverį prie „Claude“ API iškvietos naudodami MCP jungties beta antraštę:

client.beta.messages.create(
    model="claude-opus-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Remove vocals from https://example.com/song.mp3"}],
    mcp_servers=[{
        "type": "url",
        "url": "https://vocalremover.com/mcp/audio",
        "name": "vocalremover",
        "authorization_token": "YOUR_API_TOKEN",
    }],
    betas=["mcp-client-2025-11-20"],
)

„ChatGPT“ (pasirinktinis jungiklis)

„ChatGPT“ nustatymuose įjunkite „Developer“ režimą, atidarykite „Apps & Connectors“ → „Create“ ir pridėkite pasirinktinį jungiklį, nukreipiantį į žemiau nurodytą serverio URL adresą. „ChatGPT“ vykdo „OAuth“ procedūrą – prisijunkite prie „VocalRemover“ ir patvirtinkite prieigą; nereikia įklijuoti jokio žymens. (Reikalingas planas su pasirinktiniais jungikliais, pvz., „Plus“, „Pro“, „Business“ arba „Enterprise“.)

https://vocalremover.com/mcp/audio

Jūsų plane nėra prieigos prie pasirinktinio jungiklio? Vietoj to sukurkite pasirinktinį GPT ir pridėkite veiksmą, kuris importuoja mūsų OpenAPI schemą su API raktu (Bearer) autentifikavimu.

Claude (internetinė programa, „Cowork“ ir „Claude Code“)

Vieną kartą pridėkite serverį kaip pasirinktinį jungtį, tada leiskite prieigą prie tinklo, kad „Claude“ galėtų įkelti ir atsisiųsti jūsų garso įrašus.

1. Atidarykite „Tinkinti“ → „Jungtys“.
2. Spustelėkite „Pridėti jungtį“ („+“ mygtuką), tada pasirinkite „Pridėti pasirinktinę jungtį“.
3. Pavadinimą nustatykite kaip „VocalRemover“, įklijuokite žemiau nurodytą MCP serverio URL adresą ir spustelėkite „Pridėti“.
4. Prisijunkite prie „VocalRemover“ ir, kai bus paprašyta, patvirtinkite prieigą — nereikia įklijuoti jokio žymens.

https://vocalremover.com/mcp/audio

1. Atidarykite „Nustatymai“ → „Galimybės“.
2. Įjunkite parinktį „Leisti išeinančius tinklo duomenis“.
3. Pridėkite šiuos du domenus: vocalremover.com ir s3.vocalremover.com

Viskas. Pradėkite naują „Chat“, „Cowork“ arba „Claude Code“ sesiją, pridėkite garso failą ir pasakykite „pašalinti vokalą“ — „Claude“ jį įkels ir pateiks rezultatą.

Pasirinktiniai jungikliai prieinami „Claude Pro“, „Max“, „Team“ ir „Enterprise“ versijose.

Įrankiai

Vietinių failų įkėlimas

Įrankiai priima viešą URL adresą. Jei failas yra vartotojo kompiuteryje, iškvieskite nemokamą „create_upload“ įrankį, kad gautumėte vienkartinį įkėlimo URL adresą, išsiųskite failą į jį (žetono nereikia), tada perduokite grąžintą „file_url“ bet kuriam garso įrankiui. Įkėlimo nuoroda ir failas nustoja galioti po 1 valandos. Niekada nekonvertuokite tikro garso failo į „base64“ kodą — jis yra pernelyg didelis, kad tilptų į įrankio argumentą.

Assistant calls:  create_upload { "filename": "song.mp3" }
            ->  { "upload_url": "https://vocalremover.com/api/uploads/01h...",
                  "file_url":   "https://vocalremover.com/storage/mcp-uploads/01h....mp3",
                  "upload_page":"https://vocalremover.com/upload/01h..." }

# Upload the bytes (model's sandbox, a terminal, or the user's browser):
curl -F "file=@song.mp3" "https://vocalremover.com/api/uploads/01h..."
            ->  { "file_url": "https://vocalremover.com/storage/mcp-uploads/01h....mp3" }

Assistant calls:  separate_audio { "url": "", "task": "vocals" }

Nėra galimybės atlikti žiniatinklio užklausų (pvz., „sandboxed assistant“)? Nusiųskite vartotojui „upload_page“ nuorodą, kad jis galėtų įkelti failą naršyklėje, tada tęskite su „file_url“.

„Claude“ sistemoje failų įkėlimui reikalingas išeinantis tinklo srautas į vocalremover.com ir s3.vocalremover.com — įjunkite šią funkciją meniu „Nustatymai“ → „Galimybės“ (žr. „Claude“ nustatymus aukščiau).

Pavyzdys: vokalo pašalinimas

Tiesiog paprastai paprašykite savo asistento:

You: Remove the vocals from https://example.com/song.mp3

Assistant calls:  separate_audio { "url": "...", "task": "vocals" }
            ->  { "job_id": "01H...", "status": "in_process_queue" }

Assistant calls:  check_audio_job { "job_id": "01H..." }
            ->  { "done": true, "outputs": [
                    { "track": "vocals",        "download_url": "https://..." },
                    { "track": "instrumentals", "download_url": "https://..." }
                ] }

Nemokamos priemonės veikia taip pat — pavyzdžiui, komanda „convert this file to wav“ iššaukia „convert_audio“ ir iškart grąžina atsisiuntimo URL adresą, nenaudodama jokių kreditų.

Ką verta išbandyti

• ›Pašalinkite vokalą iš dainos „https://example.com/song.mp3“ ir pateikite man karaoke versiją.
• ›Išskirstykite šį takelį į atskiras takelių dalis — vokalą, būgnus, bosą, gitarą ir fortepijoną.
• ›Konvertuokite „https://example.com/interview.m4a“ į MP3 128 kbps kokybe.
• ›Iš šio vaizdo įrašo išskirkite tik garso takelį: https://example.com/clip.mp4
• ›Pašalinkite šio podkasto triukšmą ir kambario aidą: https://example.com/episode.wav
• ›Paversti šio įrašo dainininko balsą į balso tipą „tenoras-vyras“ su +2 pustonio aukščiu: https://example.com/song.mp3
• ›Sukurkite 8D versiją ir sutrumpinkite ją iki 30 sekundžių.
• ›Kokia yra „https://example.com/track.flac“ trukmė ir bitų srautas?
• ›Patikrinkite mano kredito likutį.

Apribojimai ir pastabos

• Įvesties failai turi būti vieši http(s) URL adresai, kurių kiekvieno dydis neviršija 100 MB.
• AI atskyrimas vyksta asinchroniškai — rezultatą visada tikrinkite naudodami „check_audio_job“.
• Kreditas skaičiuojamas už kiekvieną garso minutę, tik už AI atskyrimą.
• Nemokamos garso įrankiai niekada nenaudoja kreditų.

Privatumas ir saugumas

• Jūsų garso įrašas gaunamas iš jūsų nurodyto URL, apdorojamas ir ištrinamas — mes nesaugome jūsų failų.
• Jūsų API raktas galioja tik jūsų paskyrai; jį galite bet kada atšaukti API puslapyje.
• Galinis taškas veikia tik per HTTPS; mes blokuojame URL adresus, kurie nukreipia į privačius ar vidinius adresus.

Problemų sprendimas

Grįžti į MCP serverio apžvalgą