# gaudiolab-jp/gaudio-developers-mcp [Health: Active]

**Category:** 🎥 Multimedia Process  
**Repository:** https://github.com/gaudiolab-jp/gaudio-developers-mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 325  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gaudiolab-jp-gaudio-developers-mcp

## Description
Audio AI API for stem separation (vocal, drum, bass, guitar, piano), DME separation (dialogue, music, effects), and AI lyrics sync. 7 tools, 11 models, supports WAV/FLAC/MP3/M4A/MOV/MP4.

## Tools
Capabilities this server exposes over MCP:

- **gaudio_get_key_info** — Get API key info: credits, project, permitted models
- **gaudio_list_models** — List available AI models by category
- **gaudio_upload_file** — Upload audio/video/text file (multipart, auto-chunked)
- **gaudio_create_job** — Create a processing job
- **gaudio_get_job** — Check job status and get download URLs
- **gaudio_separate_audio** — All-in-one: upload → process → download URLs
- **gaudio_sync_lyrics** — All-in-one lyrics sync with timestamps

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "gaudio-developers-mcp": {
    "command": "npx",
    "args": ["-y","@gaudiolab/mcp-developers"],
    "env": {
      "GAUDIO_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `GAUDIO_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What gaudiolab-jp/gaudio-developers-mcp MCP server does

The gaudiolab-jp/gaudio-developers-mcp MCP server connects MCP-compatible clients to the Gaudio Lab Audio AI API. It supports three main workflows: separating musical stems, separating dialogue/music/effects tracks, and aligning lyrics with timestamps.

Stem separation models can produce vocal, drum, bass, electric guitar, acoustic piano, or speech outputs depending on the selected model. DME models handle dialogue, vocals, music, and effects in different combinations. The lyrics workflow accepts UTF-8 text files and returns synchronized lyric data as CSV with timestamps, lyric text, and confidence scores, along with a JSON report.

Supported inputs include WAV, FLAC, MP3, M4A, MOV, MP4, and UTF-8 TXT files. Video inputs have their audio extracted automatically. Processing outputs include MP3 at 48 kHz and 320 kbps, plus WAV in the same format as the input where applicable. Download URLs remain valid for 48 hours.

## How it works

The gaudiolab-jp/gaudio-developers-mcp MCP server can perform the API workflow in stages: upload a file, create a processing job, poll the job status, and retrieve download URLs. Upload identifiers remain reusable for 72 hours, allowing multiple jobs to use the same uploaded file.

Two higher-level operations wrap this sequence. `gaudio_separate_audio` handles upload, processing, and result retrieval for audio separation. `gaudio_sync_lyrics` provides the corresponding end-to-end workflow for lyric synchronization. The staged tools are useful when an agent needs to inspect or control individual steps.

File limits depend on the model family. Stem separation accepts files up to 1 GB and 20 minutes, DME separation accepts up to 10 GB and 200 minutes, and lyric synchronization accepts up to 1 GB and 10 minutes. Lyric files must contain at least two lines, with a maximum of 60 characters per line.

## Setup and configuration

The gaudiolab-jp/gaudio-developers-mcp MCP server requires a Gaudio Developers account, a project, and an API key created in the Gaudio dashboard. Set the key in the `GAUDIO_API_KEY` environment variable.

A local stdio configuration runs the published npm package with `npx`:

```json
{
  "mcpServers": {
    "gaudio": {
      "command": "npx",
      "args": ["-y", "@gaudiolab/mcp-developers"],
      "env": {
        "GAUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

The package is intended for MCP-compatible clients, including Claude, Cursor, VS Code, GitHub Copilot, and other clients that support MCP. The API key controls project access, available models, and credit information.

## Tools and capabilities

- `gaudio_get_key_info` reports credits, project details, and permitted models.
- `gaudio_list_models` lists available models by category.
- `gaudio_upload_file` uploads audio, video, or text using multipart transfer with automatic chunking.
- `gaudio_create_job` starts a processing job.
- `gaudio_get_job` checks job status and returns download URLs.
- `gaudio_separate_audio` combines upload, processing, and result retrieval for separation tasks.
- `gaudio_sync_lyrics` runs lyric synchronization and returns timestamped results.

The repository is licensed under MIT. API access requires the Gaudio Developers service and an API key; the provided material does not specify service pricing or credit costs.

_Full upstream README: https://allmcps.com/mcp/gaudiolab-jp-gaudio-developers-mcp/readme_