@thesashadev/ssh-mcp-server 1.0.0

package/dist/ssh-manager.js.map

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

package/dist/tools/download.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Download a remote file to the local machine with 5 fallback strategies.
+ *
+ * Strategies (tried in order):
+ * 1. SFTP fastGet — high-speed parallel download
+ * 2. SFTP createReadStream — streamed download
+ * 3. SCP via exec + stdout — cat remotePath > local
+ * 4. Base64 via exec — base64 remotePath, decode locally
+ * 5. Chunked read via exec — dd with offset/count
+ */
+export declare function downloadFile(params: {
+    serverId: string;
+    remotePath: string;
+    localPath: string;
+    overwrite?: boolean;
+}): Promise<string>;
+//# sourceMappingURL=download.d.ts.map

package/dist/tools/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/tools/download.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiFlB"}

package/dist/tools/download.js

@@ -0,0 +1,207 @@
+import { createWriteStream, writeFileSync } from 'fs';
+import { basename, dirname } from 'path';
+import { getSftp, getConnection } from '../ssh-manager.js';
+import { escapeRemotePath, normalizeRemotePath, ensureLocalDir } from '../utils/path-utils.js';
+/**
+ * Download a remote file to the local machine with 5 fallback strategies.
+ *
+ * Strategies (tried in order):
+ * 1. SFTP fastGet — high-speed parallel download
+ * 2. SFTP createReadStream — streamed download
+ * 3. SCP via exec + stdout — cat remotePath > local
+ * 4. Base64 via exec — base64 remotePath, decode locally
+ * 5. Chunked read via exec — dd with offset/count
+ */
+export async function downloadFile(params) {
+    const { serverId, remotePath: rawRemotePath, localPath, overwrite = true } = params;
+    const remotePath = normalizeRemotePath(rawRemotePath);
+    // Check local file existence
+    if (!overwrite) {
+        try {
+            const { statSync } = await import('fs');
+            statSync(localPath);
+            return `Error: Local file "${localPath}" already exists and overwrite=false.`;
+        }
+        catch { }
+    }
+    // Ensure local parent directory exists
+    try {
+        await ensureLocalDir(dirname(localPath));
+    }
+    catch (err) {
+        return `Error: Cannot create local directory "${dirname(localPath)}": ${err.message}`;
+    }
+    const errors = [];
+    const fileName = basename(remotePath);
+    const startTime = Date.now();
+    // Get remote file size for reporting
+    let fileSize = null;
+    try {
+        const sftp = await getSftp(serverId);
+        fileSize = await new Promise((resolve) => {
+            sftp.stat(remotePath, (err, stats) => {
+                resolve(err ? null : stats.size);
+            });
+        });
+    }
+    catch { }
+    // Strategy 1: SFTP fastGet
+    try {
+        await strategy1_sftpFastGet(serverId, remotePath, localPath);
+        const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+        return `SUCCESS: downloaded via SFTP fastGet\nfile: ${fileName}${fileSize !== null ? ` (${formatSize(fileSize)})` : ''}\nsaved_to: ${localPath}\nduration: ${duration}s`;
+    }
+    catch (err) {
+        errors.push(`Strategy 1 (SFTP fastGet): ${err.message}`);
+    }
+    // Strategy 2: SFTP stream
+    try {
+        await strategy2_sftpStream(serverId, remotePath, localPath);
+        const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+        return `SUCCESS: downloaded via SFTP stream\nfile: ${fileName}${fileSize !== null ? ` (${formatSize(fileSize)})` : ''}\nsaved_to: ${localPath}\nduration: ${duration}s`;
+    }
+    catch (err) {
+        errors.push(`Strategy 2 (SFTP stream): ${err.message}`);
+    }
+    // Strategy 3: SCP via cat
+    try {
+        await strategy3_scpCat(serverId, remotePath, localPath);
+        const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+        return `SUCCESS: downloaded via SCP cat\nfile: ${fileName}\nsaved_to: ${localPath}\nduration: ${duration}s`;
+    }
+    catch (err) {
+        errors.push(`Strategy 3 (SCP cat): ${err.message}`);
+    }
+    // Strategy 4: Base64 decode
+    try {
+        await strategy4_base64(serverId, remotePath, localPath);
+        const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+        return `SUCCESS: downloaded via base64\nfile: ${fileName}\nsaved_to: ${localPath}\nduration: ${duration}s`;
+    }
+    catch (err) {
+        errors.push(`Strategy 4 (Base64): ${err.message}`);
+    }
+    // Strategy 5: Chunked dd
+    try {
+        await strategy5_chunkedDd(serverId, remotePath, localPath);
+        const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+        return `SUCCESS: downloaded via chunked dd\nfile: ${fileName}\nsaved_to: ${localPath}\nduration: ${duration}s`;
+    }
+    catch (err) {
+        errors.push(`Strategy 5 (chunked dd): ${err.message}`);
+    }
+    return `FAILED: download failed, all 5 strategies exhausted\nremote: ${remotePath}\nlocal: ${localPath}\n\nerrors:\n${errors.map((e, i) => `  ${i + 1}. ${e}`).join('\n')}`;
+}
+// --- Strategy Implementations ---
+async function strategy1_sftpFastGet(serverId, remotePath, localPath) {
+    const sftp = await getSftp(serverId);
+    return new Promise((resolve, reject) => {
+        sftp.fastGet(remotePath, localPath, {
+            concurrency: 64,
+            chunkSize: 65536,
+        }, (err) => {
+            if (err)
+                reject(err);
+            else
+                resolve();
+        });
+    });
+}
+async function strategy2_sftpStream(serverId, remotePath, localPath) {
+    const sftp = await getSftp(serverId);
+    return new Promise((resolve, reject) => {
+        const readStream = sftp.createReadStream(remotePath);
+        const writeStream = createWriteStream(localPath);
+        readStream.on('error', (err) => reject(err));
+        writeStream.on('error', (err) => reject(err));
+        writeStream.on('close', () => resolve());
+        readStream.pipe(writeStream);
+    });
+}
+async function strategy3_scpCat(serverId, remotePath, localPath) {
+    const client = await getConnection(serverId);
+    const escaped = escapeRemotePath(remotePath);
+    return new Promise((resolve, reject) => {
+        client.exec(`cat ${escaped}`, (err, stream) => {
+            if (err)
+                return reject(err);
+            const writeStream = createWriteStream(localPath);
+            let stderr = '';
+            stream.stderr.on('data', (data) => { stderr += data.toString(); });
+            writeStream.on('error', (e) => reject(e));
+            writeStream.on('close', () => {
+                if (stderr.trim()) {
+                    reject(new Error(`cat stderr: ${stderr.trim()}`));
+                }
+                else {
+                    resolve();
+                }
+            });
+            stream.on('close', (code) => {
+                writeStream.end();
+                if (code !== 0 && code !== null) {
+                    reject(new Error(`cat exited with code ${code}: ${stderr}`));
+                }
+            });
+            stream.pipe(writeStream);
+        });
+    });
+}
+async function strategy4_base64(serverId, remotePath, localPath) {
+    const client = await getConnection(serverId);
+    const escaped = escapeRemotePath(remotePath);
+    const b64Data = await execCollect(client, `base64 ${escaped}`);
+    const clean = b64Data.replace(/\s/g, '');
+    const buffer = Buffer.from(clean, 'base64');
+    writeFileSync(localPath, buffer);
+}
+async function strategy5_chunkedDd(serverId, remotePath, localPath) {
+    const client = await getConnection(serverId);
+    const escaped = escapeRemotePath(remotePath);
+    // Get file size first
+    const sizeOutput = await execCollect(client, `stat -c '%s' ${escaped} 2>/dev/null || stat -f '%z' ${escaped} 2>/dev/null`);
+    const fileSize = parseInt(sizeOutput.trim(), 10);
+    if (isNaN(fileSize)) {
+        throw new Error('Cannot determine remote file size');
+    }
+    const CHUNK_SIZE = 262144; // 256KB chunks
+    const chunks = [];
+    for (let offset = 0; offset < fileSize; offset += CHUNK_SIZE) {
+        const count = Math.min(CHUNK_SIZE, fileSize - offset);
+        const b64Chunk = await execCollect(client, `dd if=${escaped} bs=1 skip=${offset} count=${count} 2>/dev/null | base64`);
+        const clean = b64Chunk.replace(/\s/g, '');
+        chunks.push(Buffer.from(clean, 'base64'));
+    }
+    writeFileSync(localPath, Buffer.concat(chunks));
+}
+// --- Helpers ---
+function execCollect(client, command) {
+    return new Promise((resolve, reject) => {
+        client.exec(command, (err, stream) => {
+            if (err)
+                return reject(err);
+            let output = '';
+            let stderr = '';
+            stream.on('data', (data) => { output += data.toString(); });
+            stream.stderr.on('data', (data) => { stderr += data.toString(); });
+            stream.on('close', (code) => {
+                if (code !== 0 && code !== null) {
+                    reject(new Error(`Command failed (exit ${code}): ${stderr || output}`));
+                }
+                else {
+                    resolve(output);
+                }
+            });
+        });
+    });
+}
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+    return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)}GB`;
+}
+//# sourceMappingURL=download.js.map

package/dist/tools/download.js.map

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

package/dist/tools/execute.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Execute a command via SSH.
+ * Supports sync mode (wait for completion) and async mode (return immediately).
+ */
+export declare function executeCommand(params: {
+    serverId: string;
+    command: string;
+    cwd?: string;
+    timeoutMs?: number;
+    async?: boolean;
+    commandId?: string;
+}): Promise<string>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/tools/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/tools/execute.ts"],"names":[],"mappings":"AA+BA;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBlB"}

package/dist/tools/execute.js

@@ -0,0 +1,195 @@
+import { randomUUID } from 'crypto';
+import { getConnection } from '../ssh-manager.js';
+import { cleanOutput, formatCommandResult } from '../utils/output-format.js';
+import { escapeRemotePath } from '../utils/path-utils.js';
+const asyncCommands = new Map();
+// Cleanup old finished commands after 30 min
+setInterval(() => {
+    const cutoff = Date.now() - 30 * 60 * 1000;
+    for (const [id, cmd] of asyncCommands) {
+        if (cmd.status !== 'running' && cmd.startedAt < cutoff) {
+            asyncCommands.delete(id);
+        }
+    }
+}, 60000).unref();
+/**
+ * Execute a command via SSH.
+ * Supports sync mode (wait for completion) and async mode (return immediately).
+ */
+export async function executeCommand(params) {
+    // If commandId is provided, we're checking status of an async command
+    if (params.commandId) {
+        return getAsyncStatus(params.commandId);
+    }
+    const { serverId, command, cwd, timeoutMs = 30000, async: isAsync = false } = params;
+    // Wrap command with cd if cwd specified
+    let fullCommand = command;
+    if (cwd) {
+        fullCommand = `cd ${escapeRemotePath(cwd)} && ${command}`;
+    }
+    const client = await getConnection(serverId);
+    if (isAsync) {
+        return startAsyncCommand(serverId, fullCommand, command, timeoutMs);
+    }
+    return runSyncCommand(client, fullCommand, timeoutMs);
+}
+async function runSyncCommand(client, command, timeoutMs) {
+    return new Promise((resolve) => {
+        const startTime = Date.now();
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        const timeout = setTimeout(() => {
+            timedOut = true;
+            try {
+                stream?.close();
+            }
+            catch { }
+        }, timeoutMs);
+        let stream;
+        client.exec(command, (err, s) => {
+            if (err) {
+                clearTimeout(timeout);
+                resolve(formatCommandResult({
+                    stdout: '',
+                    stderr: err.message,
+                    exitCode: -1,
+                    timedOut: false,
+                    duration: Date.now() - startTime,
+                }));
+                return;
+            }
+            stream = s;
+            s.on('data', (data) => {
+                stdout += data.toString('utf-8');
+                // Cap buffer at 5MB to prevent memory issues
+                if (stdout.length > 5 * 1024 * 1024) {
+                    stdout = stdout.slice(-2 * 1024 * 1024);
+                }
+            });
+            s.stderr.on('data', (data) => {
+                stderr += data.toString('utf-8');
+                if (stderr.length > 2 * 1024 * 1024) {
+                    stderr = stderr.slice(-1 * 1024 * 1024);
+                }
+            });
+            s.on('close', (code, signal) => {
+                clearTimeout(timeout);
+                resolve(formatCommandResult({
+                    stdout,
+                    stderr,
+                    exitCode: code,
+                    signal,
+                    timedOut,
+                    duration: Date.now() - startTime,
+                }));
+            });
+            s.on('error', (streamErr) => {
+                clearTimeout(timeout);
+                resolve(formatCommandResult({
+                    stdout,
+                    stderr: stderr + '\n' + streamErr.message,
+                    exitCode: -1,
+                    timedOut: false,
+                    duration: Date.now() - startTime,
+                }));
+            });
+        });
+    });
+}
+async function startAsyncCommand(serverId, fullCommand, displayCommand, timeoutMs) {
+    const id = randomUUID().slice(0, 12);
+    const asyncCmd = {
+        id,
+        serverId,
+        command: displayCommand,
+        stdout: '',
+        stderr: '',
+        exitCode: null,
+        signal: null,
+        status: 'running',
+        startedAt: Date.now(),
+    };
+    asyncCommands.set(id, asyncCmd);
+    const client = await getConnection(serverId);
+    client.exec(fullCommand, (err, stream) => {
+        if (err) {
+            asyncCmd.status = 'error';
+            asyncCmd.error = err.message;
+            return;
+        }
+        asyncCmd.stream = stream;
+        // Set timeout
+        if (timeoutMs > 0) {
+            setTimeout(() => {
+                if (asyncCmd.status === 'running') {
+                    asyncCmd.status = 'timeout';
+                    try {
+                        stream.close();
+                    }
+                    catch { }
+                }
+            }, timeoutMs).unref();
+        }
+        stream.on('data', (data) => {
+            asyncCmd.stdout += data.toString('utf-8');
+            // Cap buffer
+            if (asyncCmd.stdout.length > 5 * 1024 * 1024) {
+                asyncCmd.stdout = asyncCmd.stdout.slice(-2 * 1024 * 1024);
+            }
+        });
+        stream.stderr.on('data', (data) => {
+            asyncCmd.stderr += data.toString('utf-8');
+            if (asyncCmd.stderr.length > 2 * 1024 * 1024) {
+                asyncCmd.stderr = asyncCmd.stderr.slice(-1 * 1024 * 1024);
+            }
+        });
+        stream.on('close', (code, signal) => {
+            if (asyncCmd.status === 'running') {
+                asyncCmd.status = 'done';
+            }
+            asyncCmd.exitCode = code;
+            asyncCmd.signal = signal;
+        });
+        stream.on('error', (streamErr) => {
+            asyncCmd.status = 'error';
+            asyncCmd.error = streamErr.message;
+        });
+    });
+    return `Command started asynchronously.\nCommand ID: ${id}\nUse this ID with command_id parameter to check status and output later.`;
+}
+function getAsyncStatus(commandId) {
+    const cmd = asyncCommands.get(commandId);
+    if (!cmd) {
+        return `Command "${commandId}" not found. It may have expired (commands are cleaned up after 30 minutes).`;
+    }
+    const elapsed = ((Date.now() - cmd.startedAt) / 1000).toFixed(1);
+    const parts = [
+        `Command: ${cmd.command}`,
+        `Server: ${cmd.serverId}`,
+        `Status: ${cmd.status.toUpperCase()}`,
+        `Running for: ${elapsed}s`,
+    ];
+    if (cmd.exitCode !== null) {
+        parts.push(`Exit code: ${cmd.exitCode}`);
+    }
+    if (cmd.signal) {
+        parts.push(`Signal: ${cmd.signal}`);
+    }
+    if (cmd.error) {
+        parts.push(`Error: ${cmd.error}`);
+    }
+    const cleanStdout = cleanOutput(cmd.stdout);
+    const cleanStderr = cleanOutput(cmd.stderr);
+    if (cleanStdout) {
+        parts.push(`\n--- STDOUT (latest) ---\n${cleanStdout}`);
+    }
+    if (cleanStderr) {
+        parts.push(`\n--- STDERR ---\n${cleanStderr}`);
+    }
+    if (!cleanStdout && !cleanStderr && cmd.status === 'running') {
+        parts.push('(no output yet)');
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=execute.js.map

package/dist/tools/execute.js.map

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

package/dist/tools/upload.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Upload a local file to a remote server with 5 fallback strategies.
+ *
+ * Strategies (tried in order):
+ * 1. SFTP fastPut — high-speed parallel transfer
+ * 2. SFTP createWriteStream — streamed transfer
+ * 3. SCP via exec + stdin pipe — cat > remotePath
+ * 4. Base64 via exec — encode/decode
+ * 5. Chunked echo via exec — small base64 chunks appended
+ */
+export declare function uploadFile(params: {
+    serverId: string;
+    localPath: string;
+    remotePath: string;
+    overwrite?: boolean;
+}): Promise<string>;
+//# sourceMappingURL=upload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/tools/upload.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkElB"}