Dokumentacija o strežniku Audio MCP

Povežite zvočni orodjarski komplet VocalRemover s svojim AI-pomočnikom in začnite urejati zvočne datoteke z naravnim jezikom.

Pregled

Strežnik uporablja protokol Model Context Protocol prek Streamable HTTP. Usmerite kateri koli MCP-odjemalec na spodnjo končno točko in se avtentificirajte z API-žetonom VocalRemover. Datoteke se posredujejo kot javni http(s)-URL-ji (do 100 MB), rezultati pa se vrnejo kot URL-ji za prenos.

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

Hitri začetek

  1. Pridobite brezplačen API-žeton na Stran API.
  2. Dodajte strežnik v svoj odjemalec s pomočjo spodnjega odlomka kode.
  3. Vprašajte: »Odstrani vokale iz

Preverjanje pristnosti

  1. Ustvarite brezplačen račun in odprite Stran API.
  2. Ustvarite API-žeton.
  3. Dodajte ga kot Bearer token v konfiguracijo vašega MCP odjemalca (glejte spodaj).

Ta žeton uporabljajo tako brezplačna avdio orodja kot tudi plačljiva orodja z umetno inteligenco; razlika je le v tem, ali se zaračunavajo krediti za pretvorbene minute.

Nastavitve odjemalca

Dodajte strežnik v svoj AI odjemalec. Claude Desktop uporablja most mcp-remote; Cursor, Windsurf, Cline, Zed in Claude Code podpirajo oddaljeni MCP že v osnovi s tokenom Bearer; ChatGPT in spletna aplikacija Claude.ai ga dodata kot prilagojen konektor in se prijavita prek OAuth (glejte spodaj).

Claude Desktop

Dodajte v datoteko claude_desktop_config.json, nato pa ponovno zaženite Claude.

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

Cursor · Windsurf · Cline · Zed

Nativni oddaljeni MCP — dodajte v datoteko mcp.json stranke.

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

Claude Code (CLI)

En ukaz — nativni oddaljeni MCP, brez mostu.

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

API za antropična sporočila (ustvarite svojega agenta)

Povežite strežnik s klicem API-ja Claude z glavo MCP connector beta:

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 (prilagojeni konektor)

V nastavitvah ChatGPT omogočite razvijalski način, odprite Aplikacije in povezovalniki → Ustvari ter dodajte prilagojeni povezovalnik, ki kaže na spodnji URL strežnika. ChatGPT izvede postopek OAuth – prijavite se v VocalRemover in odobrite dostop; ni treba vstavljati žetona. (Potreben je načrt s prilagojenimi konektorji, npr. Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

V vašem načrtu ni dostopa do prilagojenega konektorja? Namesto tega ustvarite prilagojeni GPT in dodajte akcijo, ki uvozi našo shemo OpenAPI z avtentifikacijo prek API-ključa (Bearer).

Claude (spletna aplikacija, Cowork & Claude Code)

Strežnik enkrat dodajte kot prilagojeni konektor, nato pa omogočite omrežni dostop, da bo Claude lahko naložil in prenesel vaše avdio datoteke.

1. Dodajte konektor
  1. Odprite »Prilagajanje« → »Konektorji«.
  2. Kliknite Dodaj konektor (gumb +) in izberite Dodaj prilagojen konektor.
  3. Ime nastavite na »VocalRemover«, vnesite spodnji URL strežnika MCP in kliknite Dodaj.
  4. Prijavite se v VocalRemover in potrdite dostop, ko vas sistem za to zaprosi — ni treba vstavljati žetona.
https://vocalremover.com/mcp/audio
2. Omogočite dostop do omrežja (da bo lahko nalagal datoteke)
  1. Odprite Nastavitve → Zmožnosti.
  2. Vklopite možnost »Dovoli izhod iz omrežja«.
  3. Dodajte ti dve domeni: vocalremover.com in s3.vocalremover.com

To je vse. Začnite novo sejo v Chat, Cowork ali Claude Code, priložite avdio datoteko in recite »odstrani vokale« — Claude jo naloži in vam vrne rezultat.

Prilagojeni konektorji so na voljo v različicah Claude Pro, Max, Team in Enterprise.

Orodja

Orodje Raven Parametri Kaj počne
probe_audio Brezplačno url Vrne trajanje datoteke, bitno hitrost, format in ocenjene stroške kreditov.
convert_audio Brezplačno url, format Prekodirajte avdio v formate mp3, wav, flac, ogg, m4a, aac ali opus in pridobite povezavo za prenos.
trim_audio Brezplačno url, start_seconds, duration_seconds Izreži del avdio datoteke in vrni URL za prenos.
extract_audio Brezplačno url Iz video datoteke izvlečete avdio posnetek v formatu MP3.
separate_audio Zahvale url, task Začni ločevanje z umetno inteligenco (vokal, instrumental, glavni vokal, posamezne glasbene linije, odstranjevanje šuma, odstranjevanje odmeva). Vrne ID naloge.
clone_voice Zahvale url, voice, pitch? Preoblikujte glas v avdio datoteki v ciljno glasovno identifikacijo. Izbirno spreminjanje višine tona v poltonih. Vrne job_id — preverite check_audio_job za pretvorjeni avdio posnetek.
check_audio_job Brezplačno job_id Preverite stanje naloge ločevanja ali pretvorbe glasu in po zaključku pridobite URL-je za prenos izhodnih datotek.
check_balance Brezplačno Prikaži, koliko kreditov za pretvorbene minute je še na računu.

Nalaganje lokalnih datotek

Orodja sprejemajo javni URL. Če je datoteka na uporabnikovem računalniku, pokličite brezplačno orodje create_upload, da pridobite enkratni URL za nalaganje, datoteko nanj pošljite s POST zahtevkom (žeton ni potreben), nato pa vrnjeni file_url posredujte kateremu koli avdio orodju. Povezava za nalaganje in datoteka potečeta po 1 uri. Nikoli ne kodirajte prave zvočne datoteke v base64 — je prevelika za argument orodja.

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" }

Ni mogoče izvesti spletnih zahtev (npr. pomočnik v peskovniku)? Uporabniku pošljite povezavo upload_page, da datoteko prenese v brskalnik, nato pa nadaljujte z file_url.

V Claudu je za nalaganje datotek potrebna izhodna povezava z vocalremover.com in s3.vocalremover.com — vklopite jo v Nastavitve → Zmožnosti (glejte zgornjo nastavitev Clauda).

Primer: odstranitev vokala

Preprosto vprašajte svojega pomočnika v preprostem jeziku:

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://..." }
                ] }

Brezplačna orodja delujejo na enak način — na primer ukaz »pretvori to datoteko v wav« pokliče funkcijo convert_audio in takoj vrne povezavo za prenos, pri čemer se ne porabijo nobeni krediti.

Stvari, ki jih je vredno poskusiti

  • Odstranite vokale iz pesmi »https://example.com/song.mp3« in mi dajte karaoke posnetek.
  • Razdelite to skladbo na posamezne glasbene plasti — vokal, bobni, bas, kitara in klavir.
  • Pretvorite datoteko »https://example.com/interview.m4a« v MP3 s hitrostjo 128 kbps.
  • Iz tega videoposnetka izločite samo avdio: https://example.com/clip.mp4
  • Odstranite šum iz tega podkasta in odmev v prostoru: https://example.com/episode.wav
  • Pretvorite pevčev glas v tej skladbi v glasovno identifikacijo »tenor-moški« z višino tona +2 poltona: https://example.com/song.mp3
  • Naredite 8D različico in jo skrajšajte na 30 sekund.
  • Kakšna sta trajanje in bitna hitrost datoteke »https://example.com/track.flac«?
  • Preveri stanje mojega kredita.

Omejitve in opombe

  • Vhodne datoteke morajo biti javni URL-ji http(s), vsaka največ 100 MB.
  • Ločevanje AI poteka asinhrono — za rezultat vedno preverite check_audio_job.
  • Stroški se zaračunavajo na minuto avdio posnetka, in sicer le za ločevanje z umetno inteligenco.
  • Brezplačna avdio orodja nikoli ne porabljajo kreditov.

Zasebnost in varnost

  • Vaš avdio posnetek se prenese z URL-ja, ki ga posredujete, obdela in izbriše — vaših datotek ne shranjujemo.
  • Vaš API-žeton velja le za vaš račun; kadarkoli ga lahko prekličete na strani API.
  • Končna točka je na voljo izključno prek protokola HTTPS; blokiramo URL-je, ki se razrešijo v zasebne/notranje naslove.

Odpravljanje težav

»Potrebna je avtentifikacija«: Token manjka ali je glava napačna — mora biti natančno Authorization: Bearer YOUR_API_TOKEN.

»Datoteke ni bilo mogoče prenesti«: URL mora biti javno dostopen – brez zahteve po prijavi in ne sme preusmerjati na zasebni naslov.

Zdi se, da je naloga ločevanja zastala: Naloge AI so asinhrone — preverjajte check_audio_job po 10–30 sekundah, dokler vrednost done ni true.

Claude Desktop se ne poveže: Prepričajte se, da je Node/npx nameščen in v vaši PATH, uporabite mcp-remote@latest ter po urejanju konfiguracije v celoti ponovno zaženite Claude.

Nazaj na pregled strežnika MCP