Τεκμηρίωση διακομιστή Audio MCP

Επισκόπηση

Ο διακομιστής χρησιμοποιεί το πρωτόκολλο Model Context Protocol μέσω Streamable HTTP. Συνδέστε οποιονδήποτε πελάτη MCP στο παρακάτω τελικό σημείο και πραγματοποιήστε έλεγχο ταυτότητας με ένα διακριτικό API VocalRemover. Τα αρχεία μεταφέρονται ως δημόσιες διευθύνσεις URL http(s) (μέγιστου μεγέθους 100 MB) και τα αποτελέσματα επιστρέφονται ως διευθύνσεις URL από τις οποίες μπορείτε να κατεβάσετε τα αρχεία.

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

Γρήγορη εκκίνηση

1. Αποκτήστε ένα δωρεάν token API στο Σελίδα API.
2. Προσθέστε τον διακομιστή στον πελάτη σας χρησιμοποιώντας το παρακάτω απόσπασμα κώδικα.
3. Ζητήστε: «Αφαίρεσε τα φωνητικά από το ».

Πιστοποίηση

1. Δημιουργήστε έναν δωρεάν λογαριασμό και ανοίξτε το Σελίδα API.
2. Δημιουργήστε ένα διακριτικό API.
3. Προσθέστε το ως διακριτικό Bearer στη διαμόρφωση του πελάτη MCP (βλ. παρακάτω).

Τόσο τα δωρεάν εργαλεία επεξεργασίας ήχου όσο και τα επί πληρωμή εργαλεία τεχνητής νοημοσύνης χρησιμοποιούν αυτό το token· η μόνη διαφορά είναι αν χρεώνονται μονάδες για τα λεπτά μετατροπής.

Ρυθμίσεις πελάτη

Προσθέστε τον διακομιστή στον πελάτη AI σας. Το Claude Desktop χρησιμοποιεί τη γέφυρα mcp-remote. Τα Cursor, Windsurf, Cline, Zed και Claude Code υποστηρίζουν εγγενώς το απομακρυσμένο MCP με ένα token Bearer. Το ChatGPT και η διαδικτυακή εφαρμογή Claude.ai το προσθέτουν ως προσαρμοσμένο συνδετήρα και πραγματοποιούν σύνδεση μέσω OAuth (βλ. παρακάτω).

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

API μηνυμάτων Anthropic (δημιουργήστε τον δικό σας πράκτορα)

Συνδέστε τον διακομιστή σε μια κλήση του API Claude χρησιμοποιώντας την κεφαλίδα του συνδετήρα MCP 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 (προσαρμοσμένος σύνδεσμος)

Στις ρυθμίσεις του ChatGPT, ενεργοποιήστε τη λειτουργία προγραμματιστή, ανοίξτε την ενότητα Εφαρμογές & Συνδέσεις → Δημιουργία και προσθέστε μια προσαρμοσμένη σύνδεση που να παραπέμπει στην παρακάτω διεύθυνση URL του διακομιστή. Το ChatGPT εκτελεί τη ροή OAuth — συνδέεστε στο VocalRemover και εγκρίνετε την πρόσβαση· δεν χρειάζεται να επικολλήσετε κανένα token. (Απαιτείται πακέτο με προσαρμοσμένους συνδέσμους, π.χ. Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

Δεν έχετε πρόσβαση σε προσαρμοσμένο συνδετήρα στο πακέτο σας; Δημιουργήστε ένα Custom GPT και προσθέστε μια ενέργεια που εισάγει το σχήμα OpenAPI μας με πιστοποίηση μέσω κλειδιού API (Bearer).

Claude (εφαρμογή ιστού, Cowork & Claude Code)

Προσθέστε τον διακομιστή μία φορά ως προσαρμοσμένο συνδετήρα και, στη συνέχεια, επιτρέψτε την πρόσβαση στο δίκτυο, ώστε το Claude να μπορεί να ανεβάσει και να ανακτήσει τα αρχεία ήχου σας.

1. Ανοίξτε το μενού «Προσαρμογή» → «Συνδέσεις».
2. Κάντε κλικ στο κουμπί «Προσθήκη συνδετήρα» (το κουμπί +) και, στη συνέχεια, επιλέξτε «Προσθήκη προσαρμοσμένου συνδετήρα».
3. Ορίστε το όνομα ως "VocalRemover", επικολλήστε τη διεύθυνση URL του διακομιστή MCP παρακάτω και κάντε κλικ στο κουμπί Προσθήκη.
4. Συνδεθείτε στο VocalRemover και εγκρίνετε την πρόσβαση όταν σας ζητηθεί — δεν χρειάζεται να επικολλήσετε token.

https://vocalremover.com/mcp/audio

1. Ανοίξτε τις Ρυθμίσεις → Δυνατότητες.
2. Ενεργοποιήστε την επιλογή «Να επιτρέπεται η εξερχόμενη κίνηση στο δίκτυο».
3. Προσθέστε αυτούς τους δύο τομείς: vocalremover.com και s3.vocalremover.com

Αυτό ήταν. Ξεκινήστε μια νέα συνεδρία Chat, Cowork ή Claude Code, επισυνάψτε ένα αρχείο ήχου και πείτε «αφαίρεσε τα φωνητικά» — το Claude το ανεβάζει και σας παραδίδει το αποτέλεσμα.

Οι προσαρμοσμένοι σύνδεσμοι είναι διαθέσιμοι στις εκδόσεις Claude Pro, Max, Team και Enterprise.

Εργαλεία

Μεταφόρτωση τοπικών αρχείων

Τα εργαλεία δέχονται μια δημόσια διεύθυνση URL. Εάν το αρχείο βρίσκεται στον υπολογιστή του χρήστη, καλέστε το δωρεάν εργαλείο create_upload για να λάβετε μια URL μεταφόρτωσης μίας χρήσης, στείλτε το αρχείο σε αυτήν με POST (δεν απαιτείται token) και, στη συνέχεια, περάστε τη file_url που επιστρέφεται σε οποιοδήποτε εργαλείο ήχου. Ο σύνδεσμος μεταφόρτωσης και το αρχείο λήγουν μετά από 1 ώρα. Ποτέ μην κωδικοποιείτε ένα πραγματικό αρχείο ήχου σε base64 — είναι πολύ μεγάλο για να χρησιμοποιηθεί ως όρισμα ενός εργαλείου.

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

Δεν υπάρχει τρόπος να πραγματοποιηθούν αιτήσεις στο διαδίκτυο (π.χ. ένας βοηθός σε περιβάλλον sandbox); Στείλτε στον χρήστη τον σύνδεσμο upload_page για να αποθηκεύσει το αρχείο σε έναν περιηγητή και, στη συνέχεια, συνεχίστε με το file_url.

Στο Claude, η μεταφόρτωση αρχείων απαιτεί εξερχόμενη σύνδεση δικτύου προς τα vocalremover.com και s3.vocalremover.com — ενεργοποιήστε την επιλογή αυτή από τις Ρυθμίσεις → Δυνατότητες (δείτε τη ρύθμιση του Claude παραπάνω).

Παράδειγμα: αφαίρεση φωνητικών

Απλά ρωτήστε τον βοηθό σας με απλά λόγια:

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

Τα δωρεάν εργαλεία λειτουργούν με τον ίδιο τρόπο — για παράδειγμα, η εντολή «μετατροπή αυτού του αρχείου σε wav» καλεί τη συνάρτηση convert_audio και επιστρέφει αμέσως μια διεύθυνση URL για λήψη, χωρίς να καταναλώνονται μονάδες.

Πράγματα που αξίζει να δοκιμάσετε

• ›Αφαιρέστε τα φωνητικά από το https://example.com/song.mp3 και δώστε μου το κομμάτι για καραόκε.
• ›Διαχωρίστε αυτό το κομμάτι σε ξεχωριστά κομμάτια — φωνητικά, ντραμς, μπάσο, κιθάρα και πιάνο.
• ›Μετατρέψτε το αρχείο «https://example.com/interview.m4a» σε MP3 με ρυθμό μετάδοσης 128 kbps.
• ›Εξαγάγετε μόνο τον ήχο από αυτό το βίντεο: https://example.com/clip.mp4
• ›Αποθορυβώστε αυτό το podcast και αφαιρέστε την ηχώ του χώρου: https://example.com/episode.wav
• ›Μετατρέψτε τη φωνή του τραγουδιστή σε αυτό το κομμάτι σε φωνητικό αναγνωριστικό «tenor-male» με ύψος +2 ημιτόνια: https://example.com/song.mp3
• ›Δημιουργήστε μια έκδοση 8D και περικόψτε την στα 30 δευτερόλεπτα.
• ›Ποια είναι η διάρκεια και ο ρυθμός μετάδοσης δεδομένων του αρχείου «https://example.com/track.flac»;
• ›Ελέγξτε το υπόλοιπο του λογαριασμού μου.

Περιορισμοί και σημειώσεις

• Τα αρχεία εισόδου πρέπει να είναι δημόσιες διευθύνσεις URL http(s), με μέγεθος έως 100 MB το καθένα.
• Ο διαχωρισμός AI εκτελείται ασύγχρονα — πάντα να ελέγχετε το check_audio_job για το αποτέλεσμα.
• Οι μονάδες χρεώνονται ανά λεπτό ήχου, μόνο για διαχωρισμό με τεχνητή νοημοσύνη.
• Τα δωρεάν εργαλεία ήχου δεν χρησιμοποιούν ποτέ credits.

Απόρρητο και ασφάλεια

• Τα αρχεία ήχου σας ανακτώνται από τη διεύθυνση URL που παρέχετε, υποβάλλονται σε επεξεργασία και στη συνέχεια διαγράφονται — δεν αποθηκεύουμε τα αρχεία σας.
• Το διακριτικό API σας ισχύει μόνο για τον λογαριασμό σας. Μπορείτε να το ανακαλέσετε ανά πάσα στιγμή από τη σελίδα API.
• Το τελικό σημείο λειτουργεί αποκλειστικά μέσω HTTPS. Αποκλείουμε τις διευθύνσεις URL που οδηγούν σε ιδιωτικές/εσωτερικές διευθύνσεις.

Αντιμετώπιση προβλημάτων

Επιστροφή στην επισκόπηση του διακομιστή MCP