@evolinkai/mcp 0.0.0-stage → 1.3.0

package/dist/core/src/tools/task-format.js

@@ -0,0 +1,138 @@
+import { queryTask } from '../services/api-client.js';
+import { getTaskErrorInfo } from '../services/error-handler.js';
+import { money, sleep, usdOf } from './shared.js';
+/** Result links from the gateway stay downloadable for this long. */
+export const RESULT_LINK_HOURS = 24;
+export const TERMINAL_STATUSES = new Set(['completed', 'failed', 'cancelled']);
+function kindOfUrl(url, taskType) {
+    const path = url.split('?')[0].toLowerCase();
+    if (/\.(png|jpe?g|webp|gif|bmp)$/.test(path))
+        return 'image';
+    if (/\.(mp4|mov|webm|m4v)$/.test(path))
+        return 'video';
+    if (/\.(mp3|wav|m4a|flac|ogg|aac)$/.test(path))
+        return 'audio';
+    if (taskType.includes('image'))
+        return 'image';
+    if (taskType.includes('video'))
+        return 'video';
+    if (taskType.includes('audio') || taskType.includes('music'))
+        return 'audio';
+    return 'file';
+}
+export function resultLinks(task) {
+    const seen = new Set();
+    const links = [];
+    const add = (url, kind) => {
+        if (typeof url !== 'string' || !/^https?:\/\//.test(url) || seen.has(url))
+            return;
+        seen.add(url);
+        links.push({ url, kind: kind ?? kindOfUrl(url, task.type ?? '') });
+    };
+    for (const url of task.results ?? [])
+        add(url);
+    if (Array.isArray(task.result_data)) {
+        for (const item of task.result_data) {
+            add(item.video_url, 'video');
+            add(item.image_url, 'image');
+            add(item.audio_url, 'audio');
+        }
+    }
+    return links;
+}
+/** One task as text lines and the same facts as structured content. */
+export function describeTask(task) {
+    const status = task.status ?? 'pending';
+    const links = resultLinks(task);
+    const lines = [
+        `Task ${task.id}: ${status}${status === 'completed' || status === 'failed' ? '' : ` (${task.progress ?? 0}%)`}`,
+        `Model: ${task.model}`,
+    ];
+    const structured = {
+        task_id: task.id,
+        status,
+        progress: task.progress ?? 0,
+        model: task.model,
+        type: task.type,
+    };
+    if (links.length > 0) {
+        lines.push(`Results (download links expire after ${RESULT_LINK_HOURS} hours; save them now):`);
+        for (const link of links)
+            lines.push(`- ${link.kind}: ${link.url}`);
+        structured.results = links;
+        structured.links_expire_after_hours = RESULT_LINK_HOURS;
+    }
+    const used = task.usage?.credits_used ?? task.usage?.cost?.credits;
+    if (status === 'completed' && typeof used === 'number') {
+        lines.push(`Charged: ${money(used)}`);
+        structured.charged_credits = used;
+        structured.charged_usd = task.usage?.cost?.usd ?? usdOf(used);
+    }
+    const reserved = task.usage?.credits_reserved;
+    if (status !== 'completed' && status !== 'failed' && typeof reserved === 'number' && reserved > 0) {
+        lines.push(`Reserved: ${money(reserved)} (the final charge is settled when the task finishes)`);
+        structured.reserved_credits = reserved;
+        structured.reserved_usd = usdOf(reserved);
+    }
+    if (typeof task.duration === 'number' && task.duration > 0 && TERMINAL_STATUSES.has(status)) {
+        lines.push(`Took: ${task.duration} s`);
+        structured.took_seconds = task.duration;
+    }
+    if (status === 'failed' || status === 'cancelled') {
+        const code = task.error?.code ?? (status === 'cancelled' ? 'request_cancelled' : 'unknown_error');
+        const info = getTaskErrorInfo(code);
+        const suggestion = task.error?.suggestion ? `${info.suggestion} ${task.error.suggestion}` : info.suggestion;
+        lines.push(`Error: ${code}${task.error?.message ? ` — ${task.error.message}` : ''}`);
+        lines.push('Charge: failed tasks are refunded.');
+        lines.push(`Next step: ${info.retryable ? 'You can retry with a new generate call.' : 'Change the input before retrying.'} ${suggestion}`);
+        structured.error = { code, message: task.error?.message, retryable: info.retryable, suggestion };
+        structured.refunded = true;
+    }
+    else if (status === 'completed') {
+        lines.push('Next step: give the result links to the user.');
+    }
+    else {
+        const eta = task.task_info?.estimated_time;
+        if (eta) {
+            lines.push(`Estimated time left: ~${eta} s`);
+            structured.estimated_seconds = eta;
+        }
+        lines.push(`Next step: call get_task with task_id "${task.id}" again (it can wait up to 45 s). Do not call generate again to check progress: that starts and charges a new task.`);
+    }
+    if (task.request_id) {
+        lines.push(`Request ID: ${task.request_id}`);
+        structured.request_id = task.request_id;
+    }
+    return { lines, structured };
+}
+let pollIntervalOverrideMs;
+/** Tests only: shorten the pause between task reads. */
+export function setPollIntervalForTests(ms) {
+    pollIntervalOverrideMs = ms;
+}
+/** Pause between task reads: each read of an unfinished task makes the gateway ask the provider. */
+export function pollIntervalMs(type) {
+    if (pollIntervalOverrideMs !== undefined)
+        return pollIntervalOverrideMs;
+    if (type?.includes('video'))
+        return 8_000;
+    if (type?.includes('audio') || type?.includes('music'))
+        return 6_000;
+    return 3_000;
+}
+/** Reads a task until it finishes or the deadline passes, pacing reads by task type. */
+export async function waitForTask(config, taskId, options) {
+    let task = options.initial ?? await queryTask(config, taskId, options.tool);
+    while (!TERMINAL_STATUSES.has(task.status) && !options.signal?.aborted) {
+        const interval = pollIntervalMs(task.type);
+        if (Date.now() + interval > options.deadline)
+            break;
+        await options.onPoll?.(task);
+        await sleep(interval, options.signal);
+        if (options.signal?.aborted)
+            break;
+        task = await queryTask(config, taskId, options.tool);
+    }
+    return task;
+}
+//# sourceMappingURL=task-format.js.map

package/dist/core/src/tools/task-format.js.map

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

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

@@ -0,0 +1,7 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export interface UploadFileOptions {
+    /** Allow file_path uploads. The hosted service sets false: it must never read its own disk. */
+    localFiles?: boolean;
+}
+export declare function registerUploadFile(server: McpServer, options?: UploadFileOptions): void;
+//# sourceMappingURL=upload-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upload-file.d.ts","sourceRoot":"","sources":["../../../../../core/src/tools/upload-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqCzE,MAAM,WAAW,iBAAiB;IAChC,+FAA+F;IAC/F,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAQD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,iBAAsB,GAAG,IAAI,CAgF3F"}

package/dist/core/src/tools/upload-file.js

@@ -0,0 +1,104 @@
+import { basename } from 'node:path';
+import { z } from 'zod';
+import { fileStreamUpload, fileBase64Upload, fileUrlUpload } from '../services/file-client.js';
+import { inspectBase64Upload, inspectLocalUpload, validateRemoteUploadURL, validateUploadDestination, } from '../services/upload-policy.js';
+import { WRITES, errorResult, failure, ok } from './shared.js';
+const localFileSchema = {
+    file_path: z.string().optional()
+        .describe('Absolute path under EVOLINK_UPLOAD_ALLOWED_DIRS. Provide exactly one of file_path, base64_data, or file_url.'),
+};
+const contentSchema = {
+    base64_data: z.string().optional()
+        .describe('Base64 media data for small files. Data URLs carry their MIME type; raw base64 also needs mime_type.'),
+    mime_type: z.string().optional()
+        .describe('MIME type for raw base64_data; must match the file content.'),
+    file_url: z.string().optional()
+        .describe('Public HTTPS link to the media. Loopback, private-network and credential-bearing links are refused.'),
+    upload_path: z.string().optional()
+        .describe('Optional relative folder in EvoLink storage (no ..).'),
+    file_name: z.string().optional()
+        .describe('Optional plain file name (no folders).'),
+};
+const SHARED_DESCRIPTION = [
+    'Store an image, audio or video file on EvoLink and get a link to pass to generate_* (for example in image_urls). Free; uses the file quota, and files are deleted after 72 hours.',
+    'Formats: images JPEG, PNG, GIF, WebP; audio MP3, WAV, M4A, AAC, FLAC, OGG/Opus; video MP4, MOV, WebM.',
+    'Max 100 MB; prefer file_url for large files.',
+];
+export function registerUploadFile(server, options = {}) {
+    const localFiles = options.localFiles ?? true;
+    const sourceNames = localFiles ? 'file_path, base64_data, or file_url' : 'base64_data or file_url';
+    const handler = async (params) => {
+        const { base64_data, file_url, mime_type, upload_path, file_name } = params;
+        const file_path = localFiles ? params.file_path : undefined;
+        const sources = [file_path, base64_data, file_url].filter(Boolean);
+        if (sources.length !== 1) {
+            return failure(`Provide exactly one of ${sourceNames}.`, { error: { category: 'invalid_request' } });
+        }
+        // Local checks first: a refused source never reaches the network.
+        let upload;
+        try {
+            validateUploadDestination(upload_path, file_name);
+            if (file_path) {
+                const inspected = await inspectLocalUpload(file_path);
+                upload = () => fileStreamUpload(inspected.realPath, inspected.size, inspected.mimeType, basename(inspected.realPath), upload_path, file_name);
+            }
+            else if (base64_data) {
+                const { dataUrl } = inspectBase64Upload(base64_data, mime_type);
+                upload = () => fileBase64Upload(dataUrl, upload_path, file_name);
+            }
+            else {
+                const url = validateRemoteUploadURL(file_url);
+                upload = () => fileUrlUpload(url, upload_path, file_name);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'the file was refused';
+            return failure(`Upload refused: ${message}`, { error: { category: 'invalid_request', message } });
+        }
+        try {
+            const result = await upload();
+            const data = result.data;
+            if (!data)
+                throw new Error('File API returned no upload record');
+            const lines = [
+                'File uploaded.',
+                `File URL: ${data.file_url}`,
+                `Name: ${data.original_name} · ${(data.file_size / 1024).toFixed(1)} KB · ${data.mime_type}`,
+                `Expires: ${data.expires_at}`,
+            ];
+            if (result.request_id)
+                lines.push(`Request ID: ${result.request_id}`);
+            lines.push('Next step: pass the File URL to a generate tool as input.');
+            return ok(lines.join('\n'), {
+                file_url: data.file_url,
+                download_url: data.download_url,
+                file_id: data.file_id,
+                file_name: data.original_name,
+                size_bytes: data.file_size,
+                mime_type: data.mime_type,
+                expires_at: data.expires_at,
+                ...(result.request_id ? { request_id: result.request_id } : {}),
+            });
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    };
+    if (localFiles) {
+        server.registerTool('upload_file', {
+            title: 'Upload a file',
+            description: [...SHARED_DESCRIPTION, 'Local paths work only inside EVOLINK_UPLOAD_ALLOWED_DIRS.'].join(' '),
+            inputSchema: { ...localFileSchema, ...contentSchema },
+            annotations: { title: 'Upload a file', ...WRITES },
+        }, handler);
+    }
+    else {
+        server.registerTool('upload_file', {
+            title: 'Upload a file',
+            description: [...SHARED_DESCRIPTION, 'Accepts base64_data or a public file_url.'].join(' '),
+            inputSchema: contentSchema,
+            annotations: { title: 'Upload a file', ...WRITES },
+        }, handler);
+    }
+}
+//# sourceMappingURL=upload-file.js.map

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

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

package/dist/core/src/version.d.ts

@@ -0,0 +1,3 @@
+/** Version reported in serverInfo and in the X-Evo-Client-Version header. */
+export declare const MCP_VERSION = "1.3.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/core/src/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../../core/src/version.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,eAAO,MAAM,WAAW,UAAU,CAAC"}

package/dist/core/src/version.js

@@ -0,0 +1,3 @@
+/** Version reported in serverInfo and in the X-Evo-Client-Version header. */
+export const MCP_VERSION = '1.3.0';
+//# sourceMappingURL=version.js.map

package/dist/core/src/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../../core/src/version.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/dist/evolink-media/src/index.d.ts

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

package/dist/evolink-media/src/index.d.ts.map

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

package/dist/evolink-media/src/index.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer, createConfig, getApiKey } from '../../core/src/server.js';
+async function main() {
+    getApiKey(); // validate API key early
+    const config = createConfig('official');
+    const server = createServer(config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('EvoLink Media MCP Server (official) started');
+}
+main().catch((err) => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/evolink-media/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAEjF,KAAK,UAAU,IAAI;IACjB,SAAS,EAAE,CAAC,CAAC,yBAAyB;IAEtC,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;AAC/D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@evolinkai/mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.3.0",
+  "mcpName": "ai.evolink/mcp",
+  "description": "Generate AI videos, images & music with one API key. 150+ models (Seedance, Kling, Veo, Sora, GPT Image, Suno...).",
+  "type": "module",
+  "main": "dist/evolink-media/src/index.js",
+  "bin": {
+    "evolink-mcp": "dist/evolink-media/src/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepack": "node -e \"require('fs').copyFileSync('../../LICENSE','LICENSE')\"",
+    "postpack": "node -e \"require('fs').rmSync('LICENSE',{force:true})\""
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "ai",
+    "video",
+    "image",
+    "music",
+    "generation",
+    "sora",
+    "suno",
+    "kling",
+    "veo",
+    "seedance"
+  ],
+  "author": "EvoLink AI <support@evolink.ai>",
+  "license": "Apache-2.0",
+  "homepage": "https://evolink.ai/mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Evolink-AI/evolink-mcp.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.4",
+    "typescript": "^5.7.3"
+  }
+}