@gaudiolab/mcp-developers 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gaudio Lab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,110 @@
+# @gaudiolab/mcp-developers
+
+MCP server for [Gaudio Lab](https://www.gaudiolab.com) Audio AI API. Separate vocals, instruments, dialogue, music, effects from any audio/video — or sync lyrics to timestamps — all through natural language in your AI tools.
+
+Works with Claude, ChatGPT, Cursor, VS Code, GitHub Copilot, and any MCP-compatible client.
+
+## Get Your API Key
+
+1. Sign up at [Gaudio Developers](https://developers.gaudiolab.io)
+2. Create a project and get your API key from the dashboard
+
+## Quick Start
+
+Add to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "gaudio": {
+      "command": "npx",
+      "args": ["-y", "@gaudiolab/mcp-developers"],
+      "env": {
+        "GAUDIO_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+Then just ask in natural language:
+
+- *"Separate the vocals from this file"*
+- *"Extract the dialogue from this video"*
+- *"Sync these lyrics to this song"*
+- *"What models are available?"*
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `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 |
+
+## Models
+
+### Stem Separation
+
+| Model | Description | Type Options |
+|-------|-------------|-------------|
+| `gsep_music_hq_v1` | Multi-instrument separation | vocal, drum, bass, electric_guitar, acoustic_piano |
+| `gsep_music_shq_v1` | Super HQ vocal + accompaniment | vocal |
+| `gsep_speech_hq_v1` | Speech / noise removal | speech |
+
+Max: 1GB / 20 min per file. Types can be combined (e.g. `vocal,drum`).
+
+### DME Separation (Dialogue, Music, Effects)
+
+| Model | Description |
+|-------|-------------|
+| `gsep_dme_dtrack_v1` | Dialogue extraction |
+| `gsep_dme_d2track_v1` | Dialogue + vocals |
+| `gsep_dme_metrack_v1` | Music + effects |
+| `gsep_dme_me2track_v1` | Music + effects v1 |
+| `gsep_dme_me2track_v2` | Music + effects v2 (high quality) |
+| `gsep_dme_mtrack_v1` | Music only |
+| `gsep_dme_etrack_v1` | Effects only |
+
+Max: 10GB / 200 min per file.
+
+### AI Text Sync
+
+| Model | Description | Languages |
+|-------|-------------|-----------|
+| `gts_lyrics_line_v1` | Lyrics line sync | en, ko, ja, zh-cn |
+
+Max: 1GB / 10 min. Text: `.txt` (UTF-8), min 2 lines, max 60 chars/line.
+
+Output: CSV (timestamp, lyric_text, confidence_score) + JSON report.
+
+## Supported Formats
+
+| Type | Formats |
+|------|---------|
+| Audio | WAV, FLAC, MP3, M4A |
+| Video | MOV, MP4 (audio auto-extracted) |
+| Text | TXT (UTF-8) |
+
+Output: MP3 (48kHz/320kbps) + WAV (same as input). Download URLs valid for 48 hours.
+
+## How It Works
+
+```
+Upload file → Create job → Poll status → Get download URLs
+```
+
+The high-level tools (`gaudio_separate_audio`, `gaudio_sync_lyrics`) handle this entire flow automatically. Upload IDs are valid for 72 hours and can be reused across multiple jobs.
+
+## Links
+
+- [Gaudio Developers](https://developers.gaudiolab.io) — API dashboard & key management
+- [Documentation](https://www.gaudiolab.com/docs) — Full API reference
+- [Gaudio Lab](https://www.gaudiolab.com) — Company homepage
+
+## License
+
+MIT

package/dist/api/client.d.ts

@@ -0,0 +1,27 @@
+export interface ApiResponse {
+    resultCode: number;
+    resultData?: Record<string, unknown>;
+}
+export declare class GaudioClient {
+    private apiKey;
+    constructor(apiKey: string);
+    private request;
+    uploadCreate(fileName: string, fileSize: number): Promise<{
+        uploadId: string;
+        chunkSize: number;
+        preSignedUrl: string[];
+    }>;
+    uploadChunk(presignedUrl: string, chunk: Uint8Array, contentType: string): Promise<string>;
+    uploadComplete(uploadId: string, parts: {
+        awsETag: string;
+        partNumber: number;
+    }[]): Promise<void>;
+    uploadFile(filePath: string): Promise<{
+        uploadId: string;
+    }>;
+    createJob(model: string, params: Record<string, unknown>): Promise<{
+        jobId: string;
+    }>;
+    getJob(model: string, jobId: string): Promise<ApiResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;YAIZ,OAAO;IAgDf,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IAYI,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;IAqBZ,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,GAC/C,OAAO,CAAC,IAAI,CAAC;IAOV,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAwC3D,SAAS,CACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAKvB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAGjE"}

package/dist/api/client.js

@@ -0,0 +1,106 @@
+import { readFileSync, statSync } from "node:fs";
+import { basename } from "node:path";
+import { GaudioApiError, getResultCodeMessage, getHttpErrorMessage } from "../utils/errors.js";
+const BASE_URL = "https://restapi.gaudiolab.io/developers/api/v1";
+const RATE_LIMIT_WAIT_MS = 61_000;
+const MAX_RETRIES = 2;
+export class GaudioClient {
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    async request(method, path, body) {
+        const url = `${BASE_URL}${path}`;
+        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    "x-ga-apikey": this.apiKey,
+                    "Content-Type": "application/json",
+                },
+                body: body ? JSON.stringify(body) : undefined,
+            });
+            if (response.status === 429) {
+                if (attempt < MAX_RETRIES) {
+                    await new Promise((r) => setTimeout(r, RATE_LIMIT_WAIT_MS));
+                    continue;
+                }
+                throw new GaudioApiError(getHttpErrorMessage(429), 429);
+            }
+            if (!response.ok) {
+                throw new GaudioApiError(getHttpErrorMessage(response.status), response.status);
+            }
+            const data = (await response.json());
+            if (data.resultCode !== 1000) {
+                throw new GaudioApiError(getResultCodeMessage(data.resultCode), 200, data.resultCode);
+            }
+            return data;
+        }
+        throw new GaudioApiError("Max retries exceeded");
+    }
+    async uploadCreate(fileName, fileSize) {
+        const res = await this.request("POST", "/files/upload-multipart/create", {
+            fileName,
+            fileSize,
+        });
+        return res.resultData;
+    }
+    async uploadChunk(presignedUrl, chunk, contentType) {
+        const response = await fetch(presignedUrl, {
+            method: "PUT",
+            headers: { "Content-Type": contentType },
+            body: chunk,
+        });
+        if (!response.ok) {
+            throw new GaudioApiError(`Chunk upload failed: ${response.status}`, response.status);
+        }
+        const etag = response.headers.get("ETag");
+        if (!etag) {
+            throw new GaudioApiError("ETag header missing from chunk upload response");
+        }
+        return etag.replace(/"/g, "");
+    }
+    async uploadComplete(uploadId, parts) {
+        await this.request("POST", "/files/upload-multipart/complete", {
+            uploadId,
+            parts,
+        });
+    }
+    async uploadFile(filePath) {
+        const stat = statSync(filePath);
+        const fileName = basename(filePath);
+        const fileSize = stat.size;
+        const fileBuffer = readFileSync(filePath);
+        const ext = fileName.split(".").pop()?.toLowerCase() ?? "";
+        const contentTypeMap = {
+            wav: "audio/wav",
+            flac: "audio/flac",
+            mp3: "audio/mpeg",
+            m4a: "audio/mp4",
+            mov: "video/quicktime",
+            mp4: "video/mp4",
+            txt: "text/plain",
+        };
+        const contentType = contentTypeMap[ext] ?? "application/octet-stream";
+        const { uploadId, chunkSize, preSignedUrl } = await this.uploadCreate(fileName, fileSize);
+        const parts = [];
+        for (let i = 0; i < preSignedUrl.length; i++) {
+            const start = i * chunkSize;
+            const end = Math.min(start + chunkSize, fileSize);
+            const chunk = fileBuffer.subarray(start, end);
+            const etag = await this.uploadChunk(preSignedUrl[i], new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength), contentType);
+            parts.push({ awsETag: etag, partNumber: i + 1 });
+        }
+        parts.sort((a, b) => a.partNumber - b.partNumber);
+        await this.uploadComplete(uploadId, parts);
+        return { uploadId };
+    }
+    async createJob(model, params) {
+        const res = await this.request("POST", `/${model}/jobs`, params);
+        return { jobId: res.resultData?.jobId };
+    }
+    async getJob(model, jobId) {
+        return this.request("GET", `/${model}/jobs/${jobId}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { GaudioClient } from "./api/client.js";
+import { registerListModels } from "./tools/list-models.js";
+import { registerUploadFile } from "./tools/upload-file.js";
+import { registerCreateJob } from "./tools/create-job.js";
+import { registerGetJob } from "./tools/get-job.js";
+import { registerSeparateAudio } from "./tools/separate-audio.js";
+import { registerSyncLyrics } from "./tools/sync-lyrics.js";
+const apiKey = process.env.GAUDIO_API_KEY;
+if (!apiKey) {
+    console.error("GAUDIO_API_KEY environment variable is required.");
+    process.exit(1);
+}
+const server = new McpServer({
+    name: "com.gaudiolab/mcp-developers",
+    version: "1.0.0",
+});
+const client = new GaudioClient(apiKey);
+registerListModels(server);
+registerUploadFile(server, client);
+registerCreateJob(server, client);
+registerGetJob(server, client);
+registerSeparateAudio(server, client);
+registerSyncLyrics(server, client);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;AAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,8BAA8B;IACpC,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;AAExC,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACnC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAClC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC/B,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACtC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/models/registry.d.ts

@@ -0,0 +1,14 @@
+export interface ModelInfo {
+    name: string;
+    category: "stem" | "dme" | "text_sync";
+    description: string;
+    typeOptions?: string[];
+    typeRequired: boolean;
+    maxFileSize: string;
+    maxDuration: string;
+    outputFormat: string;
+}
+export declare const MODEL_REGISTRY: ModelInfo[];
+export declare function getModel(name: string): ModelInfo | undefined;
+export declare function getModelsByCategory(category?: string): ModelInfo[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/models/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/models/registry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,EA0GrC,CAAC;AAEF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE5D;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAGlE"}

package/dist/models/registry.js

@@ -0,0 +1,116 @@
+export const MODEL_REGISTRY = [
+    // Stem Separation
+    {
+        name: "gsep_music_hq_v1",
+        category: "stem",
+        description: "High-quality multi-instrument separation. Separates vocals, drums, bass, electric guitar, and acoustic piano.",
+        typeOptions: ["vocal", "drum", "bass", "electric_guitar", "acoustic_piano"],
+        typeRequired: true,
+        maxFileSize: "1GB",
+        maxDuration: "20 minutes",
+        outputFormat: "mp3 (48kHz/320kbps) + wav (same as input)",
+    },
+    {
+        name: "gsep_music_shq_v1",
+        category: "stem",
+        description: "Super high-quality vocal + accompaniment separation.",
+        typeOptions: ["vocal"],
+        typeRequired: true,
+        maxFileSize: "1GB",
+        maxDuration: "20 minutes",
+        outputFormat: "mp3 (48kHz/320kbps) + wav (same as input)",
+    },
+    {
+        name: "gsep_speech_hq_v1",
+        category: "stem",
+        description: "Speech separation / noise removal.",
+        typeOptions: ["speech"],
+        typeRequired: true,
+        maxFileSize: "1GB",
+        maxDuration: "20 minutes",
+        outputFormat: "mp3 (48kHz/320kbps) + wav (same as input)",
+    },
+    // DME Separation
+    {
+        name: "gsep_dme_dtrack_v1",
+        category: "dme",
+        description: "Extract dialogue track from audio/video.",
+        typeRequired: false,
+        maxFileSize: "10GB",
+        maxDuration: "200 minutes",
+        outputFormat: "mp3 (48kHz/320kbps) + wav (same as input)",
+    },
+    {
+        name: "gsep_dme_d2track_v1",
+        category: "dme",
+        description: "Extract dialogue + vocals track from audio/video.",
+        typeRequired: false,
+        maxFileSize: "10GB",
+        maxDuration: "200 minutes",
+        outputFormat: "mp3 (48kHz/320kbps) + wav (same as input)",
+    },
+    {
+        name: "gsep_dme_metrack_v1",
+        category: "dme",
+        description: "Extract music + effects track (paired with dtrack).",
+        typeRequired: false,
+        maxFileSize: "10GB",
+        maxDuration: "200 minutes",
+        outputFormat: "mp3 (48kHz/320kbps) + wav (same as input)",
+    },
+    {
+        name: "gsep_dme_me2track_v1",
+        category: "dme",
+        description: "Extract music + effects track v1 (paired with d2track).",
+        typeRequired: false,
+        maxFileSize: "10GB",
+        maxDuration: "200 minutes",
+        outputFormat: "mp3 (48kHz/320kbps) + wav (same as input)",
+    },
+    {
+        name: "gsep_dme_me2track_v2",
+        category: "dme",
+        description: "Extract music + effects track v2 (high quality, paired with d2track).",
+        typeRequired: false,
+        maxFileSize: "10GB",
+        maxDuration: "200 minutes",
+        outputFormat: "mp3 (48kHz/320kbps) + wav (same as input)",
+    },
+    {
+        name: "gsep_dme_mtrack_v1",
+        category: "dme",
+        description: "Extract music-only track from audio/video.",
+        typeRequired: false,
+        maxFileSize: "10GB",
+        maxDuration: "200 minutes",
+        outputFormat: "mp3 (48kHz/320kbps) + wav (same as input)",
+    },
+    {
+        name: "gsep_dme_etrack_v1",
+        category: "dme",
+        description: "Extract effects-only track from audio/video.",
+        typeRequired: false,
+        maxFileSize: "10GB",
+        maxDuration: "200 minutes",
+        outputFormat: "mp3 (48kHz/320kbps) + wav (same as input)",
+    },
+    // AI Text Sync
+    {
+        name: "gts_lyrics_line_v1",
+        category: "text_sync",
+        description: "AI lyrics line sync. Aligns lyrics text to audio timestamps. Outputs CSV (timestamp, lyric_text, confidence_score) + JSON report.",
+        typeRequired: false,
+        maxFileSize: "1GB",
+        maxDuration: "10 minutes",
+        outputFormat: "CSV (lyrics) + JSON (report)",
+    },
+];
+export function getModel(name) {
+    return MODEL_REGISTRY.find((m) => m.name === name);
+}
+export function getModelsByCategory(category) {
+    if (!category)
+        return MODEL_REGISTRY;
+    return MODEL_REGISTRY.filter((m) => m.category === category);
+}
+//# sourceMappingURL=registry.js.map

package/dist/models/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/models/registry.ts"],"names":[],"mappings":"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"}

package/dist/tools/create-job.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { GaudioClient } from "../api/client.js";
+export declare function registerCreateJob(server: McpServer, client: GaudioClient): void;
+//# sourceMappingURL=create-job.d.ts.map

package/dist/tools/create-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-job.d.ts","sourceRoot":"","sources":["../../src/tools/create-job.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,QAgDxE"}

package/dist/tools/create-job.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import { getModel } from "../models/registry.js";
+export function registerCreateJob(server, client) {
+    server.tool("gaudio_create_job", "Create a processing job with an uploaded file. For Stem Separation models (gsep_music_hq_v1, gsep_music_shq_v1, gsep_speech_hq_v1), the 'type' parameter is required (e.g. 'vocal', 'vocal,drum'). For DME models, no type is needed. For Text Sync (gts_lyrics_line_v1), use gaudio_sync_lyrics instead.", {
+        uploadId: z.string().describe("Upload ID from gaudio_upload_file (used as audioUploadId)"),
+        model: z.string().describe("Model name (e.g. gsep_music_hq_v1, gsep_dme_dtrack_v1)"),
+        type: z
+            .string()
+            .optional()
+            .describe("Stem type(s), comma-separated. Required for Stem Separation models. e.g. 'vocal', 'vocal,drum,bass'"),
+    }, async ({ uploadId, model, type }) => {
+        const modelInfo = getModel(model);
+        if (!modelInfo) {
+            return {
+                content: [{ type: "text", text: `Unknown model: ${model}. Use gaudio_list_models to see available models.` }],
+                isError: true,
+            };
+        }
+        if (modelInfo.typeRequired && !type) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Model ${model} requires a 'type' parameter. Options: ${modelInfo.typeOptions?.join(", ")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const params = { audioUploadId: uploadId };
+        if (type)
+            params.type = type;
+        const { jobId } = await client.createJob(model, params);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ jobId, model, status: "created" }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=create-job.js.map

package/dist/tools/create-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-job.js","sourceRoot":"","sources":["../../src/tools/create-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,MAAoB;IACvE,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,2SAA2S,EAC3S;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;QAC1F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QACpF,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,qGAAqG,CAAC;KACnH,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;QAClC,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,kBAAkB,KAAK,mDAAmD,EAAE,CAAC;gBACtH,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,SAAS,CAAC,YAAY,IAAI,CAAC,IAAI,EAAE,CAAC;YACpC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,SAAS,KAAK,0CAA0C,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;qBAClG;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAA4B,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;QACpE,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QAE7B,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAExD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACnE;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-job.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { GaudioClient } from "../api/client.js";
+export declare function registerGetJob(server: McpServer, client: GaudioClient): void;
+//# sourceMappingURL=get-job.d.ts.map

package/dist/tools/get-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-job.d.ts","sourceRoot":"","sources":["../../src/tools/get-job.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,QA2CrE"}

package/dist/tools/get-job.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { getModel } from "../models/registry.js";
+export function registerGetJob(server, client) {
+    server.tool("gaudio_get_job", "Check job status and get results. Status: 'waiting' (queued), 'running' (processing), 'success' (done, downloadUrl included), 'failed' (error). Download URLs expire after 48 hours.", {
+        jobId: z.string().describe("Job ID from gaudio_create_job or gaudio_separate_audio"),
+        model: z.string().describe("Model name used to create the job"),
+    }, async ({ jobId, model }) => {
+        const modelInfo = getModel(model);
+        if (!modelInfo) {
+            return {
+                content: [{ type: "text", text: `Unknown model: ${model}` }],
+                isError: true,
+            };
+        }
+        const res = await client.getJob(model, jobId);
+        const data = res.resultData ?? {};
+        const result = {
+            jobId,
+            model,
+            status: data.status,
+        };
+        if (data.status === "success") {
+            result.downloadUrl = data.downloadUrl;
+            result.expireAt = data.expireAt;
+        }
+        else if (data.status === "failed") {
+            result.errorMessage = data.errorMessage;
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=get-job.js.map

package/dist/tools/get-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-job.js","sourceRoot":"","sources":["../../src/tools/get-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,UAAU,cAAc,CAAC,MAAiB,EAAE,MAAoB;IACpE,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,sLAAsL,EACtL;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QACpF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;KAChE,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QACzB,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,kBAAkB,KAAK,EAAE,EAAE,CAAC;gBACrE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;QAElC,MAAM,MAAM,GAA4B;YACtC,KAAK;YACL,KAAK;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YACtC,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAClC,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QAC1C,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/list-models.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerListModels(server: McpServer): void;
+//# sourceMappingURL=list-models.d.ts.map

package/dist/tools/list-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-models.d.ts","sourceRoot":"","sources":["../../src/tools/list-models.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QAiCnD"}

package/dist/tools/list-models.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { getModelsByCategory } from "../models/registry.js";
+export function registerListModels(server) {
+    server.tool("gaudio_list_models", "List available Gaudio AI models. Filter by category: 'stem' (instrument separation), 'dme' (dialogue/music/effects separation), 'text_sync' (lyrics sync).", {
+        category: z
+            .enum(["all", "stem", "dme", "text_sync"])
+            .default("all")
+            .describe("Filter by category: all (default), stem, dme, or text_sync"),
+    }, async ({ category }) => {
+        const models = getModelsByCategory(category === "all" ? undefined : category);
+        const formatted = models.map((m) => ({
+            name: m.name,
+            category: m.category,
+            description: m.description,
+            typeOptions: m.typeOptions ?? null,
+            typeRequired: m.typeRequired,
+            maxFileSize: m.maxFileSize,
+            maxDuration: m.maxDuration,
+            outputFormat: m.outputFormat,
+        }));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(formatted, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=list-models.js.map

package/dist/tools/list-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-models.js","sourceRoot":"","sources":["../../src/tools/list-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,4JAA4J,EAC5J;QACE,QAAQ,EAAE,CAAC;aACR,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;aACzC,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,4DAA4D,CAAC;KAC1E,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC9E,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI;YAClC,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,YAAY,EAAE,CAAC,CAAC,YAAY;SAC7B,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;iBACzC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/separate-audio.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { GaudioClient } from "../api/client.js";
+export declare function registerSeparateAudio(server: McpServer, client: GaudioClient): void;
+//# sourceMappingURL=separate-audio.d.ts.map

package/dist/tools/separate-audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"separate-audio.d.ts","sourceRoot":"","sources":["../../src/tools/separate-audio.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAIrD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,QA6G5E"}

package/dist/tools/separate-audio.js

@@ -0,0 +1,102 @@
+import { z } from "zod";
+import { getModel } from "../models/registry.js";
+import { pollJob } from "../utils/polling.js";
+export function registerSeparateAudio(server, client) {
+    server.tool("gaudio_separate_audio", "All-in-one audio separation: upload file (or reuse uploadId) → create job → poll until done → return download URLs. For Stem Separation, provide 'type' (e.g. 'vocal', 'vocal,drum'). For DME Separation, no type needed. Supports WAV, FLAC, MP3, M4A, MOV, MP4.", {
+        filePath: z
+            .string()
+            .optional()
+            .describe("Path to local audio/video file. Either filePath or uploadId is required."),
+        uploadId: z
+            .string()
+            .optional()
+            .describe("Existing uploadId to reuse (skips upload). Valid for 72 hours."),
+        model: z.string().describe("Model name (e.g. gsep_music_hq_v1, gsep_dme_dtrack_v1)"),
+        type: z
+            .string()
+            .optional()
+            .describe("Stem type(s) for Stem Separation models. e.g. 'vocal', 'vocal,drum'"),
+        pollInterval: z
+            .number()
+            .optional()
+            .default(10)
+            .describe("Polling interval in seconds (default: 10)"),
+    }, async ({ filePath, uploadId, model, type, pollInterval }) => {
+        const modelInfo = getModel(model);
+        if (!modelInfo) {
+            return {
+                content: [{ type: "text", text: `Unknown model: ${model}. Use gaudio_list_models to see available models.` }],
+                isError: true,
+            };
+        }
+        if (!filePath && !uploadId) {
+            return {
+                content: [{ type: "text", text: "Either filePath or uploadId is required." }],
+                isError: true,
+            };
+        }
+        if (modelInfo.typeRequired && !type) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Model ${model} requires 'type'. Options: ${modelInfo.typeOptions?.join(", ")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (modelInfo.category === "text_sync") {
+            return {
+                content: [{ type: "text", text: "For Text Sync, use gaudio_sync_lyrics instead." }],
+                isError: true,
+            };
+        }
+        const messages = [];
+        const log = (msg) => messages.push(msg);
+        // Step 1: Upload if needed
+        let resolvedUploadId = uploadId;
+        if (!resolvedUploadId) {
+            log("업로드 중...");
+            const result = await client.uploadFile(filePath);
+            resolvedUploadId = result.uploadId;
+            log(`업로드 완료. uploadId: ${resolvedUploadId}`);
+        }
+        else {
+            log(`기존 uploadId 재사용: ${resolvedUploadId}`);
+        }
+        // Step 2: Create job
+        const params = {
+            audioUploadId: resolvedUploadId,
+        };
+        if (type)
+            params.type = type;
+        const { jobId } = await client.createJob(model, params);
+        log(`Job 생성 완료. jobId: ${jobId}`);
+        // Step 3: Poll
+        const intervalMs = (pollInterval ?? 10) * 1000;
+        const result = await pollJob(client, model, jobId, intervalMs, 30, log);
+        const output = {
+            jobId: result.jobId,
+            status: result.status,
+            uploadId: resolvedUploadId,
+            model,
+        };
+        if (result.downloadUrl)
+            output.downloadUrl = result.downloadUrl;
+        if (result.expireAt)
+            output.expireAt = result.expireAt;
+        if (result.errorMessage)
+            output.errorMessage = result.errorMessage;
+        messages.push(JSON.stringify(output, null, 2));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: messages.join("\n"),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=separate-audio.js.map

package/dist/tools/separate-audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"separate-audio.js","sourceRoot":"","sources":["../../src/tools/separate-audio.ts"],"names":[],"mappings":"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"}

package/dist/tools/sync-lyrics.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { GaudioClient } from "../api/client.js";
+export declare function registerSyncLyrics(server: McpServer, client: GaudioClient): void;
+//# sourceMappingURL=sync-lyrics.d.ts.map

package/dist/tools/sync-lyrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-lyrics.d.ts","sourceRoot":"","sources":["../../src/tools/sync-lyrics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,QA8GzE"}

package/dist/tools/sync-lyrics.js

@@ -0,0 +1,96 @@
+import { z } from "zod";
+import { pollJob } from "../utils/polling.js";
+export function registerSyncLyrics(server, client) {
+    server.tool("gaudio_sync_lyrics", "All-in-one lyrics sync: upload audio + text files → create gts_lyrics_line_v1 job → poll → return CSV (timestamp, lyric_text, confidence_score) + JSON report URLs. Text file requirements: .txt format, UTF-8, minimum 2 lines, max 60 characters per line. Audio limit: 1GB / 10 minutes.", {
+        audioFilePath: z
+            .string()
+            .optional()
+            .describe("Path to local audio file. Either audioFilePath or audioUploadId required."),
+        audioUploadId: z
+            .string()
+            .optional()
+            .describe("Existing audio uploadId to reuse."),
+        textFilePath: z
+            .string()
+            .optional()
+            .describe("Path to local .txt lyrics file. Either textFilePath or textUploadId required."),
+        textUploadId: z
+            .string()
+            .optional()
+            .describe("Existing text uploadId to reuse."),
+        language: z
+            .enum(["en", "ko", "ja", "zh-cn"])
+            .describe("Language of the lyrics: en (English), ko (Korean), ja (Japanese), zh-cn (Chinese Simplified)"),
+        pollInterval: z
+            .number()
+            .optional()
+            .default(10)
+            .describe("Polling interval in seconds (default: 10)"),
+    }, async ({ audioFilePath, audioUploadId, textFilePath, textUploadId, language, pollInterval, }) => {
+        if (!audioFilePath && !audioUploadId) {
+            return {
+                content: [{ type: "text", text: "Either audioFilePath or audioUploadId is required." }],
+                isError: true,
+            };
+        }
+        if (!textFilePath && !textUploadId) {
+            return {
+                content: [{ type: "text", text: "Either textFilePath or textUploadId is required." }],
+                isError: true,
+            };
+        }
+        const messages = [];
+        const log = (msg) => messages.push(msg);
+        // Step 1: Upload audio if needed
+        let resolvedAudioId = audioUploadId;
+        if (!resolvedAudioId) {
+            log("오디오 파일 업로드 중...");
+            const res = await client.uploadFile(audioFilePath);
+            resolvedAudioId = res.uploadId;
+            log(`오디오 업로드 완료. uploadId: ${resolvedAudioId}`);
+        }
+        // Step 2: Upload text if needed
+        let resolvedTextId = textUploadId;
+        if (!resolvedTextId) {
+            log("텍스트 파일 업로드 중...");
+            const res = await client.uploadFile(textFilePath);
+            resolvedTextId = res.uploadId;
+            log(`텍스트 업로드 완료. uploadId: ${resolvedTextId}`);
+        }
+        // Step 3: Create job
+        const model = "gts_lyrics_line_v1";
+        const { jobId } = await client.createJob(model, {
+            audioUploadId: resolvedAudioId,
+            textUploadId: resolvedTextId,
+            language,
+        });
+        log(`Job 생성 완료. jobId: ${jobId}`);
+        // Step 4: Poll
+        const intervalMs = (pollInterval ?? 10) * 1000;
+        const result = await pollJob(client, model, jobId, intervalMs, 30, log);
+        const output = {
+            jobId: result.jobId,
+            status: result.status,
+            model,
+            audioUploadId: resolvedAudioId,
+            textUploadId: resolvedTextId,
+            language,
+        };
+        if (result.downloadUrl)
+            output.downloadUrl = result.downloadUrl;
+        if (result.expireAt)
+            output.expireAt = result.expireAt;
+        if (result.errorMessage)
+            output.errorMessage = result.errorMessage;
+        messages.push(JSON.stringify(output, null, 2));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: messages.join("\n"),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=sync-lyrics.js.map

package/dist/tools/sync-lyrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-lyrics.js","sourceRoot":"","sources":["../../src/tools/sync-lyrics.ts"],"names":[],"mappings":"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"}

package/dist/tools/upload-file.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { GaudioClient } from "../api/client.js";
+export declare function registerUploadFile(server: McpServer, client: GaudioClient): void;
+//# sourceMappingURL=upload-file.d.ts.map

package/dist/tools/upload-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-file.d.ts","sourceRoot":"","sources":["../../src/tools/upload-file.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,QA0BzE"}

package/dist/tools/upload-file.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export function registerUploadFile(server, client) {
+    server.tool("gaudio_upload_file", "Upload a local audio/video/text file to Gaudio servers. Handles multipart upload automatically (create → chunk upload → complete). The returned uploadId is valid for 72 hours and can be reused across multiple jobs. Supported formats: WAV, FLAC, MP3, M4A, MOV, MP4, TXT.", {
+        filePath: z
+            .string()
+            .describe("Absolute path to the local file to upload"),
+    }, async ({ filePath }) => {
+        const { uploadId } = await client.uploadFile(filePath);
+        const expiresAt = new Date(Date.now() + 72 * 60 * 60 * 1000).toISOString();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ uploadId, expiresAt }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=upload-file.js.map

package/dist/tools/upload-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-file.js","sourceRoot":"","sources":["../../src/tools/upload-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAoB;IACxE,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,+QAA+Q,EAC/Q;QACE,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,CAAC,2CAA2C,CAAC;KACzD,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAEvD,MAAM,SAAS,GAAG,IAAI,IAAI,CACxB,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CACjC,CAAC,WAAW,EAAE,CAAC;QAEhB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvD;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,8 @@
+export declare class GaudioApiError extends Error {
+    readonly statusCode?: number | undefined;
+    readonly resultCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined, resultCode?: number | undefined);
+}
+export declare function getResultCodeMessage(code: number): string;
+export declare function getHttpErrorMessage(status: number): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AA8BA,qBAAa,cAAe,SAAQ,KAAK;aAGrB,UAAU,CAAC,EAAE,MAAM;aACnB,UAAU,CAAC,EAAE,MAAM;gBAFnC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,UAAU,CAAC,EAAE,MAAM,YAAA;CAKtC;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1D"}

package/dist/utils/errors.js

@@ -0,0 +1,48 @@
+const RESULT_CODE_MESSAGES = {
+    1007: "지정한 언어가 텍스트 내용과 일치하지 않습니다.",
+    1008: "텍스트는 최소 2줄 이상 포함해야 합니다.",
+    1014: "지원하지 않는 샘플레이트입니다. 16kHz ~ 192kHz를 사용하세요.",
+    1015: "지원하지 않는 채널입니다. 모노(1ch) 또는 스테레오(2ch)를 사용하세요.",
+    1100: "알 수 없는 오류가 발생했습니다. 지속되면 Gaudio 고객지원에 문의하세요.",
+    1102: "크레딧이 부족합니다. Gaudio 대시보드에서 충전하세요.",
+    1103: "계약이 유효하지 않거나 만료되었습니다.",
+    1104: "요청한 Job을 찾을 수 없습니다.",
+    1105: "업로드 ID를 찾을 수 없습니다. 파일을 다시 업로드해주세요.",
+    1106: "업로드 ID가 만료되었습니다 (72시간). 파일을 다시 업로드해주세요.",
+    1107: "지원하지 않는 파일 형식입니다. WAV, FLAC, MP3, M4A, MOV, MP4를 사용하세요.",
+    1108: "오디오 길이가 0초입니다. 파일을 확인하세요.",
+    1109: "오디오 길이가 허용 한도를 초과했습니다.",
+    1110: "파일 크기가 허용 한도를 초과했습니다.",
+    1111: "지원하지 않는 언어입니다. en, ko, ja, zh-cn 중 선택하세요.",
+    1112: "지원하지 않는 텍스트 형식입니다. .txt 파일을 사용하세요.",
+    1113: "지원하지 않는 파일명 형식입니다.",
+    1114: "프로젝트가 삭제되었습니다.",
+    1122: "필수 파라미터 'type'이 누락되었습니다.",
+};
+const HTTP_ERROR_MESSAGES = {
+    400: "API 키가 요청 헤더에 없습니다. GAUDIO_API_KEY 환경변수를 확인하세요.",
+    401: "API 키가 유효하지 않습니다. 대시보드에서 키를 확인하세요.",
+    403: "이 API 키로 해당 모델에 접근할 수 없습니다. 프로젝트 설정을 확인하세요.",
+    405: "해당 모델은 현재 사용할 수 없습니다. 다른 모델을 사용하세요.",
+    429: "요청이 너무 많습니다. 60초 후 자동 재시도합니다.",
+};
+export class GaudioApiError extends Error {
+    statusCode;
+    resultCode;
+    constructor(message, statusCode, resultCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.resultCode = resultCode;
+        this.name = "GaudioApiError";
+    }
+}
+export function getResultCodeMessage(code) {
+    return RESULT_CODE_MESSAGES[code] ?? `알 수 없는 오류 (resultCode: ${code})`;
+}
+export function getHttpErrorMessage(status) {
+    if (status >= 500) {
+        return "Gaudio 서버에 일시적 오류가 발생했습니다. 잠시 후 다시 시도해주세요.";
+    }
+    return HTTP_ERROR_MESSAGES[status] ?? `HTTP 오류 (${status})`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,oBAAoB,GAA2B;IACnD,IAAI,EAAE,4BAA4B;IAClC,IAAI,EAAE,yBAAyB;IAC/B,IAAI,EAAE,0CAA0C;IAChD,IAAI,EAAE,6CAA6C;IACnD,IAAI,EAAE,6CAA6C;IACnD,IAAI,EAAE,kCAAkC;IACxC,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,oCAAoC;IAC1C,IAAI,EAAE,yCAAyC;IAC/C,IAAI,EAAE,yDAAyD;IAC/D,IAAI,EAAE,2BAA2B;IACjC,IAAI,EAAE,wBAAwB;IAC9B,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,2CAA2C;IACjD,IAAI,EAAE,oCAAoC;IAC1C,IAAI,EAAE,oBAAoB;IAC1B,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,0BAA0B;CACjC,CAAC;AAEF,MAAM,mBAAmB,GAA2B;IAClD,GAAG,EAAE,iDAAiD;IACtD,GAAG,EAAE,oCAAoC;IACzC,GAAG,EAAE,6CAA6C;IAClD,GAAG,EAAE,qCAAqC;IAC1C,GAAG,EAAE,+BAA+B;CACrC,CAAC;AAEF,MAAM,OAAO,cAAe,SAAQ,KAAK;IAGrB;IACA;IAHlB,YACE,OAAe,EACC,UAAmB,EACnB,UAAmB;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,eAAU,GAAV,UAAU,CAAS;QACnB,eAAU,GAAV,UAAU,CAAS;QAGnC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,oBAAoB,CAAC,IAAI,CAAC,IAAI,0BAA0B,IAAI,GAAG,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QAClB,OAAO,4CAA4C,CAAC;IACtD,CAAC;IACD,OAAO,mBAAmB,CAAC,MAAM,CAAC,IAAI,YAAY,MAAM,GAAG,CAAC;AAC9D,CAAC"}

package/dist/utils/polling.d.ts

@@ -0,0 +1,10 @@
+import type { GaudioClient } from "../api/client.js";
+export interface PollResult {
+    jobId: string;
+    status: string;
+    downloadUrl?: Record<string, unknown>;
+    errorMessage?: string;
+    expireAt?: string;
+}
+export declare function pollJob(client: GaudioClient, model: string, jobId: string, intervalMs?: number, maxAttempts?: number, onProgress?: (message: string) => void): Promise<PollResult>;
+//# sourceMappingURL=polling.d.ts.map

package/dist/utils/polling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../../src/utils/polling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,MAAe,EAC3B,WAAW,GAAE,MAAW,EACxB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACrC,OAAO,CAAC,UAAU,CAAC,CAkDrB"}

package/dist/utils/polling.js

@@ -0,0 +1,49 @@
+import { GaudioApiError } from "./errors.js";
+export async function pollJob(client, model, jobId, intervalMs = 10_000, maxAttempts = 30, onProgress) {
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        let result;
+        try {
+            result = await client.getJob(model, jobId);
+        }
+        catch (err) {
+            if (err instanceof GaudioApiError) {
+                return {
+                    jobId,
+                    status: "failed",
+                    errorMessage: err.message,
+                };
+            }
+            throw err;
+        }
+        const status = result.resultData?.status;
+        if (status === "success") {
+            onProgress?.("처리 완료!");
+            return {
+                jobId,
+                status: "success",
+                downloadUrl: result.resultData?.downloadUrl,
+                expireAt: result.resultData?.expireAt,
+            };
+        }
+        if (status === "failed") {
+            return {
+                jobId,
+                status: "failed",
+                errorMessage: result.resultData?.errorMessage ?? "Job failed",
+            };
+        }
+        if (attempt === 0) {
+            onProgress?.("처리 대기 중...");
+        }
+        else {
+            onProgress?.(`처리 중... (${attempt + 1}/${maxAttempts})`);
+        }
+        await new Promise((resolve) => setTimeout(resolve, intervalMs));
+    }
+    return {
+        jobId,
+        status: "polling_timeout",
+        errorMessage: `${maxAttempts}회 폴링 후에도 미완료. gaudio_get_job으로 나중에 확인하세요. jobId: ${jobId}`,
+    };
+}
+//# sourceMappingURL=polling.js.map

package/dist/utils/polling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.js","sourceRoot":"","sources":["../../src/utils/polling.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAU7C,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAoB,EACpB,KAAa,EACb,KAAa,EACb,aAAqB,MAAM,EAC3B,cAAsB,EAAE,EACxB,UAAsC;IAEtC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;gBAClC,OAAO;oBACL,KAAK;oBACL,MAAM,EAAE,QAAQ;oBAChB,YAAY,EAAE,GAAG,CAAC,OAAO;iBAC1B,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,EAAE,MAAgB,CAAC;QAEnD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;YACvB,OAAO;gBACL,KAAK;gBACL,MAAM,EAAE,SAAS;gBACjB,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,WAAsC;gBACtE,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE,QAAkB;aAChD,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,OAAO;gBACL,KAAK;gBACL,MAAM,EAAE,QAAQ;gBAChB,YAAY,EAAG,MAAM,CAAC,UAAU,EAAE,YAAuB,IAAI,YAAY;aAC1E,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;YAClB,UAAU,EAAE,CAAC,YAAY,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,UAAU,EAAE,CAAC,YAAY,OAAO,GAAG,CAAC,IAAI,WAAW,GAAG,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,OAAO;QACL,KAAK;QACL,MAAM,EAAE,iBAAiB;QACzB,YAAY,EAAE,GAAG,WAAW,oDAAoD,KAAK,EAAE;KACxF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@gaudiolab/mcp-developers",
+  "version": "1.0.0",
+  "description": "Gaudio Lab Audio AI API — MCP Server for Stem Separation, DME Separation, AI Text Sync",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "gaudio-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "mcp",
+    "gaudio",
+    "audio",
+    "ai",
+    "stem-separation",
+    "dme",
+    "text-sync"
+  ],
+  "author": "Gaudio Lab",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "server.json",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/server.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "com.gaudiolab/mcp-developers",
+  "description": "Gaudio Lab Audio AI API — Stem Separation, DME Separation, AI Text Sync for music, film, and media production.",
+  "repository": {
+    "url": "https://bitbucket.org/gaudiolab/mcp-developers",
+    "source": "bitbucket"
+  },
+  "version": "1.0.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@gaudiolab/mcp-developers",
+      "version": "1.0.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "GAUDIO_API_KEY",
+          "description": "Gaudio Lab API key from https://www.gaudiolab.com/developers",
+          "isRequired": true,
+          "isSecret": true
+        }
+      ]
+    }
+  ]
+}