freebeat-mcp 0.1.0

package/dist/services/freebeat-api.d.ts

@@ -0,0 +1,117 @@
+import { z } from "zod";
+import { SessionType } from "../core/task-types.js";
+declare const preSignedUrlItemSchema: z.ZodObject<{
+    signURL: z.ZodString;
+    finalStaticUrl: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    signURL: string;
+    finalStaticUrl: string;
+}, {
+    signURL: string;
+    finalStaticUrl: string;
+}>;
+declare const taskStartResponseSchema: z.ZodObject<{
+    task_id: z.ZodString;
+    status: z.ZodString;
+    task_type: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    task_id: string;
+    task_type: string;
+}, {
+    status: string;
+    task_id: string;
+    task_type: string;
+}>;
+declare const effectListItemSchema: z.ZodObject<{
+    aspectRatio: z.ZodString;
+    coverUrl: z.ZodString;
+    effectsDisplayName: z.ZodString;
+    effectsName: z.ZodString;
+    effectsTypeId: z.ZodNumber;
+    height: z.ZodNumber;
+    id: z.ZodNumber;
+    musicId: z.ZodNumber;
+    musicName: z.ZodString;
+    musicUrl: z.ZodString;
+    videoUrl: z.ZodString;
+    width: z.ZodNumber;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    aspectRatio: z.ZodString;
+    coverUrl: z.ZodString;
+    effectsDisplayName: z.ZodString;
+    effectsName: z.ZodString;
+    effectsTypeId: z.ZodNumber;
+    height: z.ZodNumber;
+    id: z.ZodNumber;
+    musicId: z.ZodNumber;
+    musicName: z.ZodString;
+    musicUrl: z.ZodString;
+    videoUrl: z.ZodString;
+    width: z.ZodNumber;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    aspectRatio: z.ZodString;
+    coverUrl: z.ZodString;
+    effectsDisplayName: z.ZodString;
+    effectsName: z.ZodString;
+    effectsTypeId: z.ZodNumber;
+    height: z.ZodNumber;
+    id: z.ZodNumber;
+    musicId: z.ZodNumber;
+    musicName: z.ZodString;
+    musicUrl: z.ZodString;
+    videoUrl: z.ZodString;
+    width: z.ZodNumber;
+}, z.ZodTypeAny, "passthrough">>;
+type PreSignedUrlResponse = z.infer<typeof preSignedUrlItemSchema>;
+export type TaskStartResponse = z.infer<typeof taskStartResponseSchema>;
+export interface TaskStatusResponse {
+    task_id: string;
+    status: string;
+    type: SessionType;
+    error_message?: string;
+    error_code?: number | string;
+}
+export interface TaskResultResponse {
+    task_id: string;
+    status: string;
+    type: SessionType;
+    error_message?: string;
+    error_code?: number | string;
+    result_payload?: string;
+}
+export type EffectListItem = z.infer<typeof effectListItemSchema>;
+export interface GenerateMusicVideoParams {
+    music_id: number;
+    prompt: string;
+    aspect_ratio?: string;
+    resolution?: number;
+    start_ms?: number;
+    end_ms?: number;
+    reference_image_urls?: string[];
+    mv_type?: "abstract" | "singing" | "storytelling";
+    style?: string;
+    watermark?: boolean;
+}
+export interface GenerateEffectParams {
+    effect_id: number;
+    music_id: number;
+    prompt: string;
+    watermark?: boolean;
+    reference_image_urls: string[];
+}
+export declare class FreebeatApiClient {
+    private httpClient;
+    constructor(baseUrl: string, apiKey: string);
+    private unwrapApiEnvelope;
+    private postAndUnwrap;
+    createUploadUrl(key: string, fileName: string, bucketName?: string): Promise<PreSignedUrlResponse>;
+    uploadToPreSignedUrl(signURL: string, fileBuffer: Buffer, contentType: string): Promise<void>;
+    saveMusicSource(copyUrl: string): Promise<number>;
+    listEffects(): Promise<EffectListItem[]>;
+    generateMusicVideo(params: GenerateMusicVideoParams): Promise<TaskStartResponse>;
+    generateEffect(params: GenerateEffectParams): Promise<TaskStartResponse>;
+    getTaskStatus(taskId: string): Promise<TaskStatusResponse>;
+    getTaskResult(taskId: string): Promise<TaskResultResponse>;
+}
+export {};

package/dist/services/freebeat-api.js

@@ -0,0 +1,188 @@
+import axios from "axios";
+import { z } from "zod";
+import { AppError } from "../core/errors.js";
+import { EFFECT_SESSION_TYPE, EFFECT_TASK_TYPE, MUSIC_VIDEO_SESSION_TYPE, MUSIC_VIDEO_TASK_TYPE, } from "../core/task-types.js";
+const preSignedUrlItemSchema = z.object({
+    signURL: z.string(),
+    finalStaticUrl: z.string(),
+});
+const apiResponseEnvelopeSchema = z.object({
+    code: z.number(),
+    msg: z.string().optional(),
+    data: z.unknown().optional(),
+});
+const preSignedUrlListSchema = z.array(preSignedUrlItemSchema).min(1);
+const taskStartResponseSchema = z.object({
+    task_id: z.string(),
+    status: z.string(),
+    task_type: z.string(),
+});
+const trackIdResponseSchema = z.object({
+    trackId: z.string(),
+});
+const sessionTypeSchema = z.union([z.number(), z.string()]);
+const errorCodeSchema = z.union([z.number().int(), z.string()]);
+const querySessionStatusResponseSchema = z.object({
+    status: z.string(),
+    trackId: z.string().optional(),
+    type: sessionTypeSchema,
+    errorMsg: z.string().optional(),
+    errorCode: errorCodeSchema.optional(),
+}).passthrough();
+const querySessionResultResponseSchema = querySessionStatusResponseSchema.extend({
+    resultPayload: z.string().optional(),
+}).passthrough();
+const effectListItemSchema = z.object({
+    aspectRatio: z.string(),
+    coverUrl: z.string(),
+    effectsDisplayName: z.string(),
+    effectsName: z.string(),
+    effectsTypeId: z.number(),
+    height: z.number(),
+    id: z.number(),
+    musicId: z.number(),
+    musicName: z.string(),
+    musicUrl: z.string(),
+    videoUrl: z.string(),
+    width: z.number(),
+}).passthrough();
+const effectListResponseSchema = z.object({
+    anchor: z.union([z.string(), z.number()]).optional(),
+    end: z.boolean().optional(),
+    list: z.array(effectListItemSchema),
+});
+export class FreebeatApiClient {
+    httpClient;
+    constructor(baseUrl, apiKey) {
+        this.httpClient = axios.create({
+            baseURL: baseUrl,
+            timeout: 30_000,
+            headers: {
+                Authorization: apiKey,
+            },
+        });
+    }
+    unwrapApiEnvelope(payload, dataSchema, action, invalidDataMessage = `${action}: unexpected response format`) {
+        const envelope = apiResponseEnvelopeSchema.safeParse(payload);
+        if (!envelope.success) {
+            throw new AppError(`${action}: unexpected response format`, "INVALID_RESPONSE");
+        }
+        if (envelope.data.code !== 0) {
+            throw new AppError(`${action} failed: ${envelope.data.msg ?? "unknown error"}`, "API_ERROR");
+        }
+        if (envelope.data.data === undefined) {
+            throw new AppError(invalidDataMessage, "INVALID_RESPONSE");
+        }
+        const parsedData = dataSchema.safeParse(envelope.data.data);
+        if (!parsedData.success) {
+            throw new AppError(invalidDataMessage, "INVALID_RESPONSE");
+        }
+        return parsedData.data;
+    }
+    async postAndUnwrap(path, body, dataSchema, action, invalidDataMessage = `${action}: unexpected response format`) {
+        const response = await this.httpClient.post(path, body);
+        return this.unwrapApiEnvelope(response.data, dataSchema, action, invalidDataMessage);
+    }
+    async createUploadUrl(key, fileName, bucketName = "") {
+        const list = await this.postAndUnwrap("/v1/mcp/agent/genUploadSignUrl", { reqList: [{ key, fileName, bucketName }] }, preSignedUrlListSchema, "createUploadUrl");
+        return list[0];
+    }
+    async uploadToPreSignedUrl(signURL, fileBuffer, contentType) {
+        const uploadHeaders = {
+            "Content-Type": contentType,
+        };
+        const signedHeaders = new URL(signURL).searchParams
+            .get("X-Amz-SignedHeaders")
+            ?.split(";")
+            .map((header) => header.trim().toLowerCase()) ?? [];
+        if (signedHeaders.includes("x-amz-acl")) {
+            uploadHeaders["x-amz-acl"] = "public-read";
+        }
+        await axios.put(signURL, fileBuffer, {
+            headers: uploadHeaders,
+            timeout: 300_000,
+        });
+    }
+    async saveMusicSource(copyUrl) {
+        return this.postAndUnwrap("/v1/mcp/agent/saveMusicV3", { copyUrl }, z.number(), "saveMusicSource");
+    }
+    async listEffects() {
+        const result = await this.postAndUnwrap("/v1/mcp/agent/getAiAgentVeEffectsVideoList", {
+            anchor: 1,
+            limit: 1000,
+            effectsTypeIdList: [],
+            maxTypeCount: 1,
+        }, effectListResponseSchema, "listEffects");
+        return result.list;
+    }
+    async generateMusicVideo(params) {
+        if (!Number.isInteger(params.music_id)) {
+            throw new AppError("generateMusicVideo: music_id must be an integer", "INVALID_PARAMS");
+        }
+        if (params.resolution !== undefined && ![720, 1080].includes(params.resolution)) {
+            throw new AppError("generateMusicVideo: resolution must be either 720 or 1080", "INVALID_PARAMS");
+        }
+        const response = await this.postAndUnwrap("/v1/mcp/openMv/createSession", {
+            type: MUSIC_VIDEO_SESSION_TYPE,
+            mvMode: "fast",
+            mvType: params.mv_type,
+            style: params.style,
+            musicId: params.music_id,
+            musicStartMs: params.start_ms,
+            musicEndMs: params.end_ms,
+            prompt: params.prompt,
+            aspectRatio: params.aspect_ratio,
+            resolution: params.resolution,
+            watermark: params.watermark,
+            personaImgUrls: params.reference_image_urls,
+        }, trackIdResponseSchema, "generateMusicVideo", "generateMusicVideo: missing trackId in response");
+        return {
+            task_id: response.trackId,
+            task_type: MUSIC_VIDEO_TASK_TYPE,
+            status: "pending",
+        };
+    }
+    async generateEffect(params) {
+        if (!Number.isInteger(params.effect_id)) {
+            throw new AppError("generateEffect: effect_id must be an integer", "INVALID_PARAMS");
+        }
+        if (!Number.isInteger(params.music_id)) {
+            throw new AppError("generateEffect: music_id must be an integer", "INVALID_PARAMS");
+        }
+        const response = await this.postAndUnwrap("/v1/mcp/openMv/createSession", {
+            type: EFFECT_SESSION_TYPE,
+            effectsTypeId: params.effect_id,
+            musicId: params.music_id,
+            prompt: params.prompt,
+            watermark: params.watermark,
+            personaImgUrls: params.reference_image_urls,
+        }, trackIdResponseSchema, "generateEffect", "generateEffect: missing trackId in response");
+        return {
+            task_id: response.trackId,
+            task_type: EFFECT_TASK_TYPE,
+            status: "pending",
+        };
+    }
+    async getTaskStatus(taskId) {
+        const parsed = await this.postAndUnwrap("/v1/mcp/openMv/querySessionStatus", { trackId: taskId }, querySessionStatusResponseSchema, "getTaskStatus", "getTaskStatus: unexpected session status response");
+        return {
+            task_id: parsed.trackId ?? taskId,
+            status: parsed.status,
+            type: parsed.type,
+            error_message: parsed.errorMsg,
+            error_code: parsed.errorCode,
+        };
+    }
+    async getTaskResult(taskId) {
+        const parsed = await this.postAndUnwrap("/v1/mcp/openMv/querySessionResult", { trackId: taskId }, querySessionResultResponseSchema, "getTaskResult", "getTaskResult: unexpected session result response");
+        return {
+            task_id: parsed.trackId ?? taskId,
+            status: parsed.status,
+            type: parsed.type,
+            error_message: parsed.errorMsg,
+            error_code: parsed.errorCode,
+            result_payload: parsed.resultPayload,
+        };
+    }
+}
+//# sourceMappingURL=freebeat-api.js.map

package/dist/services/freebeat-api.js.map

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

package/dist/services/upload-service.d.ts

@@ -0,0 +1,13 @@
+import { FreebeatApiClient } from "./freebeat-api.js";
+export interface UploadLocalFileParams {
+    filePath: string;
+    keyPrefix: string;
+    bucketName?: string;
+    contentType: string;
+    keySuffix?: string;
+}
+export declare class UploadService {
+    private readonly client;
+    constructor(client: Pick<FreebeatApiClient, "createUploadUrl" | "uploadToPreSignedUrl">);
+    uploadLocalFile({ filePath, keyPrefix, bucketName, contentType, keySuffix, }: UploadLocalFileParams): Promise<string>;
+}

package/dist/services/upload-service.js

@@ -0,0 +1,22 @@
+import fs from "fs";
+import path from "path";
+import { safeExtension } from "../utils/file.js";
+export class UploadService {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async uploadLocalFile({ filePath, keyPrefix, bucketName = "freebeat-static", contentType, keySuffix, }) {
+        const filename = path.basename(filePath);
+        const ext = safeExtension(filePath);
+        const timestamp = Date.now();
+        const rand = Math.random().toString(36).slice(2, 8);
+        const suffix = keySuffix ? `_${keySuffix}` : "";
+        const key = `${keyPrefix}/${timestamp}${suffix}_${rand}.${ext}`;
+        const { signURL, finalStaticUrl } = await this.client.createUploadUrl(key, filename, bucketName);
+        const fileBuffer = await fs.promises.readFile(filePath);
+        await this.client.uploadToPreSignedUrl(signURL, fileBuffer, contentType);
+        return finalStaticUrl;
+    }
+}
+//# sourceMappingURL=upload-service.js.map

package/dist/services/upload-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-service.js","sourceRoot":"","sources":["../../src/services/upload-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAUjD,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,MAG5B;QAH4B,WAAM,GAAN,MAAM,CAGlC;IAAG,CAAC;IAEL,KAAK,CAAC,eAAe,CAAC,EACpB,QAAQ,EACR,SAAS,EACT,UAAU,GAAG,iBAAiB,EAC9B,WAAW,EACX,SAAS,GACa;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,GAAG,SAAS,IAAI,SAAS,GAAG,MAAM,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;QAEhE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CACnE,GAAG,EACH,QAAQ,EACR,UAAU,CACX,CAAC;QAEF,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACxD,MAAM,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QAEzE,OAAO,cAAc,CAAC;IACxB,CAAC;CACF"}

package/dist/utils/file.d.ts

@@ -0,0 +1,5 @@
+export declare function detectAudioMimeType(filePath: string): string;
+export declare function detectImageMimeType(filePath: string): string;
+export declare function safeExtension(filePath: string): string;
+export declare function validateAudioFile(filePath: string): void;
+export declare function validateImageFile(filePath: string): void;

package/dist/utils/file.js

@@ -0,0 +1,69 @@
+import fs from "fs";
+import path from "path";
+import mime from "mime-types";
+import { AppError } from "../core/errors.js";
+const AUDIO_CONFIG = {
+    acceptedTypes: [
+        "audio/mpeg",
+        "audio/wav",
+        "audio/ogg",
+        "audio/flac",
+        "audio/aac",
+    ],
+    normalizeMap: {
+        "audio/wave": "audio/wav",
+        "audio/x-flac": "audio/flac",
+        "audio/x-aac": "audio/aac",
+    },
+    maxSize: 50 * 1024 * 1024,
+    label: "audio",
+};
+const IMAGE_CONFIG = {
+    acceptedTypes: ["image/png", "image/jpeg"],
+    normalizeMap: {
+        "image/jpg": "image/jpeg",
+    },
+    maxSize: 10 * 1024 * 1024,
+    label: "image",
+};
+function detectMime(filePath, normalizeMap) {
+    const mimeType = mime.lookup(filePath);
+    if (!mimeType) {
+        throw new AppError(`Cannot detect MIME type for file: ${filePath}`, "INVALID_PARAMS");
+    }
+    return normalizeMap[mimeType] ?? mimeType;
+}
+function validateFile(filePath, config) {
+    if (!fs.existsSync(filePath)) {
+        throw new AppError(`File not found: ${filePath}`, "FILE_NOT_FOUND");
+    }
+    const mimeType = detectMime(filePath, config.normalizeMap);
+    if (!config.acceptedTypes.includes(mimeType)) {
+        throw new AppError(`Unsupported ${config.label} type: ${mimeType}. Accepted: ${config.acceptedTypes.join(", ")}`, "UNSUPPORTED_TYPE");
+    }
+    const stats = fs.statSync(filePath);
+    if (stats.size > config.maxSize) {
+        const maxMB = config.maxSize / 1024 / 1024;
+        throw new AppError(`File too large: ${(stats.size / 1024 / 1024).toFixed(2)}MB. Max: ${maxMB}MB`, "FILE_TOO_LARGE");
+    }
+}
+export function detectAudioMimeType(filePath) {
+    return detectMime(filePath, AUDIO_CONFIG.normalizeMap);
+}
+export function detectImageMimeType(filePath) {
+    return detectMime(filePath, IMAGE_CONFIG.normalizeMap);
+}
+export function safeExtension(filePath) {
+    const ext = path.extname(filePath).slice(1).toLowerCase();
+    if (!/^[a-z0-9]+$/.test(ext)) {
+        throw new AppError(`Invalid file extension: ${ext}`, "INVALID_PARAMS");
+    }
+    return ext;
+}
+export function validateAudioFile(filePath) {
+    validateFile(filePath, AUDIO_CONFIG);
+}
+export function validateImageFile(filePath) {
+    validateFile(filePath, IMAGE_CONFIG);
+}
+//# sourceMappingURL=file.js.map

package/dist/utils/file.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "freebeat-mcp",
+  "version": "0.1.0",
+  "description": "Freebeat MCP Server",
+  "type": "module",
+  "bin": {
+    "freebeat-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "pretest": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["mcp", "freebeat", "ai", "music-video"],
+  "author": "Freebeat",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/freebeatfit/freebeat-mcp.git"
+  },
+  "homepage": "https://github.com/freebeatfit/freebeat-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/freebeatfit/freebeat-mcp/issues"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.0",
+    "axios": "^1.7.0",
+    "mime-types": "^2.1.35",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/mime-types": "^2.1.4",
+    "@types/node": "^20.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^3.0.0"
+  }
+}