@thesashadev/ssh-mcp-server 1.0.0

package/dist/tools/upload.js

@@ -0,0 +1,216 @@
+import { readFileSync, createReadStream, statSync } from 'fs';
+import { basename } from 'path';
+import { getSftp, getConnection } from '../ssh-manager.js';
+import { escapeRemotePath, normalizeRemotePath, ensureRemoteDir, remoteDir } from '../utils/path-utils.js';
+/**
+ * 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 async function uploadFile(params) {
+    const { serverId, localPath, remotePath: rawRemotePath, overwrite = true } = params;
+    const remotePath = normalizeRemotePath(rawRemotePath);
+    // Validate local file exists
+    let fileSize;
+    try {
+        const stat = statSync(localPath);
+        if (!stat.isFile()) {
+            return `Error: "${localPath}" is not a file.`;
+        }
+        fileSize = stat.size;
+    }
+    catch (err) {
+        return `Error: Cannot access local file "${localPath}": ${err.message}`;
+    }
+    const errors = [];
+    const fileName = basename(localPath);
+    const startTime = Date.now();
+    // Strategy 1: SFTP fastPut
+    try {
+        const result = await strategy1_sftpFastPut(serverId, localPath, remotePath, overwrite);
+        const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+        return `SUCCESS: uploaded via SFTP fastPut\nfile: ${fileName} (${formatSize(fileSize)})\nremote: ${remotePath}\nduration: ${duration}s`;
+    }
+    catch (err) {
+        errors.push(`Strategy 1 (SFTP fastPut): ${err.message}`);
+    }
+    // Strategy 2: SFTP stream
+    try {
+        const result = await strategy2_sftpStream(serverId, localPath, remotePath, overwrite);
+        const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+        return `SUCCESS: uploaded via SFTP stream\nfile: ${fileName} (${formatSize(fileSize)})\nremote: ${remotePath}\nduration: ${duration}s`;
+    }
+    catch (err) {
+        errors.push(`Strategy 2 (SFTP stream): ${err.message}`);
+    }
+    // Strategy 3: SCP via stdin pipe
+    try {
+        await strategy3_scpPipe(serverId, localPath, remotePath);
+        const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+        return `SUCCESS: uploaded via SCP pipe\nfile: ${fileName} (${formatSize(fileSize)})\nremote: ${remotePath}\nduration: ${duration}s`;
+    }
+    catch (err) {
+        errors.push(`Strategy 3 (SCP pipe): ${err.message}`);
+    }
+    // Strategy 4: Base64
+    try {
+        await strategy4_base64(serverId, localPath, remotePath);
+        const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+        return `SUCCESS: uploaded via base64\nfile: ${fileName} (${formatSize(fileSize)})\nremote: ${remotePath}\nduration: ${duration}s`;
+    }
+    catch (err) {
+        errors.push(`Strategy 4 (Base64): ${err.message}`);
+    }
+    // Strategy 5: Chunked echo
+    try {
+        await strategy5_chunkedEcho(serverId, localPath, remotePath);
+        const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+        return `SUCCESS: uploaded via chunked base64\nfile: ${fileName} (${formatSize(fileSize)})\nremote: ${remotePath}\nduration: ${duration}s`;
+    }
+    catch (err) {
+        errors.push(`Strategy 5 (chunked echo): ${err.message}`);
+    }
+    return `FAILED: upload failed, all 5 strategies exhausted\nlocal: ${localPath}\nremote: ${remotePath}\n\nerrors:\n${errors.map((e, i) => `  ${i + 1}. ${e}`).join('\n')}`;
+}
+// --- Strategy Implementations ---
+async function strategy1_sftpFastPut(serverId, localPath, remotePath, overwrite) {
+    const sftp = await getSftp(serverId);
+    await ensureRemoteDir(sftp, remoteDir(remotePath));
+    if (!overwrite) {
+        const exists = await new Promise(resolve => {
+            sftp.stat(remotePath, (err) => resolve(!err));
+        });
+        if (exists)
+            throw new Error('File already exists and overwrite=false');
+    }
+    return new Promise((resolve, reject) => {
+        sftp.fastPut(localPath, remotePath, {
+            concurrency: 64,
+            chunkSize: 65536,
+            step: (transferred, chunk, total) => {
+                // Progress tracking available if needed
+            },
+        }, (err) => {
+            if (err)
+                reject(err);
+            else
+                resolve();
+        });
+    });
+}
+async function strategy2_sftpStream(serverId, localPath, remotePath, overwrite) {
+    const sftp = await getSftp(serverId);
+    await ensureRemoteDir(sftp, remoteDir(remotePath));
+    if (!overwrite) {
+        const exists = await new Promise(resolve => {
+            sftp.stat(remotePath, (err) => resolve(!err));
+        });
+        if (exists)
+            throw new Error('File already exists and overwrite=false');
+    }
+    return new Promise((resolve, reject) => {
+        const readStream = createReadStream(localPath);
+        const writeStream = sftp.createWriteStream(remotePath);
+        writeStream.on('close', () => resolve());
+        writeStream.on('error', (err) => reject(err));
+        readStream.on('error', (err) => reject(err));
+        readStream.pipe(writeStream);
+    });
+}
+async function strategy3_scpPipe(serverId, localPath, remotePath) {
+    const client = await getConnection(serverId);
+    const escaped = escapeRemotePath(remotePath);
+    // Ensure parent directory exists
+    const parentDir = escapeRemotePath(remoteDir(remotePath));
+    await execSimple(client, `mkdir -p ${parentDir}`);
+    return new Promise((resolve, reject) => {
+        client.exec(`cat > ${escaped}`, (err, stream) => {
+            if (err)
+                return reject(err);
+            let error = null;
+            stream.on('close', () => {
+                if (error)
+                    reject(error);
+                else
+                    resolve();
+            });
+            stream.on('error', (e) => { error = e; });
+            const readStream = createReadStream(localPath);
+            readStream.on('error', (e) => {
+                error = e;
+                stream.close();
+            });
+            readStream.pipe(stream);
+        });
+    });
+}
+async function strategy4_base64(serverId, localPath, remotePath) {
+    const client = await getConnection(serverId);
+    const fileData = readFileSync(localPath);
+    const b64 = fileData.toString('base64');
+    const escaped = escapeRemotePath(remotePath);
+    const parentDir = escapeRemotePath(remoteDir(remotePath));
+    // Ensure parent dir and decode base64
+    const cmd = `mkdir -p ${parentDir} && echo '${b64}' | base64 -d > ${escaped}`;
+    // If command is too long (>100KB), fall through to chunked
+    if (cmd.length > 100000) {
+        throw new Error('File too large for single base64 transfer, use chunked strategy');
+    }
+    await execSimple(client, cmd);
+}
+async function strategy5_chunkedEcho(serverId, localPath, remotePath) {
+    const client = await getConnection(serverId);
+    const fileData = readFileSync(localPath);
+    const b64 = fileData.toString('base64');
+    const escaped = escapeRemotePath(remotePath);
+    const parentDir = escapeRemotePath(remoteDir(remotePath));
+    await execSimple(client, `mkdir -p ${parentDir}`);
+    const CHUNK_SIZE = 100000; // ~100KB per chunk
+    const tempFile = `${remotePath}.b64tmp`;
+    const escapedTemp = escapeRemotePath(tempFile);
+    // Clear temp file
+    await execSimple(client, `> ${escapedTemp}`);
+    // Write chunks
+    for (let i = 0; i < b64.length; i += CHUNK_SIZE) {
+        const chunk = b64.slice(i, i + CHUNK_SIZE);
+        await execSimple(client, `printf '%s' '${chunk}' >> ${escapedTemp}`);
+    }
+    // Decode and move
+    await execSimple(client, `base64 -d ${escapedTemp} > ${escaped} && rm -f ${escapedTemp}`);
+}
+// --- Helpers ---
+function execSimple(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) {
+                    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=upload.js.map

package/dist/tools/upload.js.map

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

package/dist/utils/output-format.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Cleans SSH output for AI readability:
+ * - Strips ANSI escape codes
+ * - Removes control characters
+ * - Collapses excessive blank lines
+ * - Truncates very long lines
+ * - Detects and replaces binary data
+ * - Converts tab-separated data to aligned columns
+ */
+export declare function cleanOutput(raw: string | Buffer): string;
+/**
+ * Format command result for AI consumption
+ */
+export declare function formatCommandResult(opts: {
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    signal?: string | null;
+    timedOut?: boolean;
+    duration?: number;
+}): string;
+/**
+ * Format directory listing for AI
+ */
+export declare function formatLsOutput(raw: string): string;
+//# sourceMappingURL=output-format.d.ts.map

package/dist/utils/output-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format.d.ts","sourceRoot":"","sources":["../../src/utils/output-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CA+CxD;AAgBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAmCT;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYlD"}

package/dist/utils/output-format.js

@@ -0,0 +1,117 @@
+/**
+ * Cleans SSH output for AI readability:
+ * - Strips ANSI escape codes
+ * - Removes control characters
+ * - Collapses excessive blank lines
+ * - Truncates very long lines
+ * - Detects and replaces binary data
+ * - Converts tab-separated data to aligned columns
+ */
+const ANSI_REGEX = /\x1B\[[0-9;]*[A-Za-z]|\x1B\][^\x07]*\x07|\x1B[()][AB012]|\x1B\[?[0-9;]*[hlm]/g;
+const CONTROL_CHARS_REGEX = /[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g;
+const CARRIAGE_RETURN_REGEX = /\r\n?/g;
+const MAX_LINE_LENGTH = 2000;
+const MAX_CONSECUTIVE_BLANKS = 2;
+const BINARY_THRESHOLD = 0.15; // If more than 15% non-text chars, consider binary
+export function cleanOutput(raw) {
+    if (Buffer.isBuffer(raw)) {
+        if (isBinaryData(raw)) {
+            return `[binary data, ${raw.length} bytes]`;
+        }
+        raw = raw.toString('utf-8');
+    }
+    if (typeof raw !== 'string')
+        return '';
+    // Strip ANSI escape codes
+    let output = raw.replace(ANSI_REGEX, '');
+    // Normalize line endings
+    output = output.replace(CARRIAGE_RETURN_REGEX, '\n');
+    // Remove control characters (keep \n and \t)
+    output = output.replace(CONTROL_CHARS_REGEX, '');
+    // Process line by line
+    const lines = output.split('\n');
+    const processedLines = [];
+    let consecutiveBlanks = 0;
+    for (let line of lines) {
+        // Truncate very long lines
+        if (line.length > MAX_LINE_LENGTH) {
+            line = line.substring(0, MAX_LINE_LENGTH) + ' [...truncated]';
+        }
+        // Collapse excessive blank lines
+        if (line.trim() === '') {
+            consecutiveBlanks++;
+            if (consecutiveBlanks > MAX_CONSECUTIVE_BLANKS)
+                continue;
+        }
+        else {
+            consecutiveBlanks = 0;
+        }
+        processedLines.push(line);
+    }
+    // Trim trailing blank lines
+    while (processedLines.length > 0 && processedLines[processedLines.length - 1].trim() === '') {
+        processedLines.pop();
+    }
+    return processedLines.join('\n');
+}
+function isBinaryData(buf) {
+    if (buf.length === 0)
+        return false;
+    const sampleSize = Math.min(buf.length, 8192);
+    let nonTextCount = 0;
+    for (let i = 0; i < sampleSize; i++) {
+        const byte = buf[i];
+        // Non-text: anything outside printable ASCII + common whitespace
+        if (byte < 0x09 || (byte > 0x0D && byte < 0x20) || byte === 0x7F) {
+            nonTextCount++;
+        }
+    }
+    return nonTextCount / sampleSize > BINARY_THRESHOLD;
+}
+/**
+ * Format command result for AI consumption
+ */
+export function formatCommandResult(opts) {
+    const parts = [];
+    if (opts.timedOut) {
+        parts.push('TIMED_OUT: command exceeded timeout limit');
+    }
+    if (opts.duration !== undefined) {
+        parts.push(`Duration: ${(opts.duration / 1000).toFixed(1)}s`);
+    }
+    if (opts.exitCode !== null && opts.exitCode !== undefined) {
+        parts.push(`Exit code: ${opts.exitCode}${opts.exitCode !== 0 ? ' (FAILURE)' : ''}`);
+    }
+    if (opts.signal) {
+        parts.push(`Signal: ${opts.signal}`);
+    }
+    const cleanStdout = cleanOutput(opts.stdout);
+    const cleanStderr = cleanOutput(opts.stderr);
+    if (cleanStdout) {
+        parts.push(`\n--- STDOUT ---\n${cleanStdout}`);
+    }
+    if (cleanStderr) {
+        parts.push(`\n--- STDERR ---\n${cleanStderr}`);
+    }
+    if (!cleanStdout && !cleanStderr) {
+        parts.push('(no output)');
+    }
+    return parts.join('\n');
+}
+/**
+ * Format directory listing for AI
+ */
+export function formatLsOutput(raw) {
+    const cleaned = cleanOutput(raw);
+    // If it looks like `ls -la` output, try to clean up the alignment
+    const lines = cleaned.split('\n');
+    if (lines.length < 2)
+        return cleaned;
+    // Check if it looks like ls -la (starts with "total" or permission string)
+    const hasLsHeader = /^total\s+\d+/.test(lines[0]);
+    if (!hasLsHeader)
+        return cleaned;
+    // Collapse multiple spaces in ls output for cleaner display
+    return lines.map(line => line.replace(/\s{2,}/g, '  ')).join('\n');
+}
+//# sourceMappingURL=output-format.js.map

package/dist/utils/output-format.js.map

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

package/dist/utils/path-utils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Escape a remote path for safe use in shell commands.
+ * Handles spaces, quotes, special characters.
+ */
+export declare function escapeRemotePath(remotePath: string): string;
+/**
+ * Normalize a local path — handle Windows/Unix differences.
+ */
+export declare function normalizeLocalPath(localPath: string): string;
+/**
+ * Normalize a remote path — ensure Unix-style.
+ */
+export declare function normalizeRemotePath(remotePath: string): string;
+/**
+ * Get parent directory of a remote path.
+ */
+export declare function remoteDir(remotePath: string): string;
+/**
+ * Join remote path segments (Unix-style).
+ */
+export declare function remoteJoin(...segments: string[]): string;
+/**
+ * Create remote directory recursively via SFTP.
+ */
+export declare function ensureRemoteDir(sftp: any, dirPath: string): Promise<void>;
+/**
+ * Create local directory recursively.
+ */
+export declare function ensureLocalDir(dirPath: string): Promise<void>;
+/**
+ * Check if a remote path exists.
+ */
+export declare function remoteExists(sftp: any, remotePath: string): Promise<boolean>;
+//# sourceMappingURL=path-utils.d.ts.map

package/dist/utils/path-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../src/utils/path-utils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAsB,eAAe,CACjC,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMlF"}

package/dist/utils/path-utils.js

@@ -0,0 +1,87 @@
+import { posix, win32 } from 'path';
+/**
+ * Escape a remote path for safe use in shell commands.
+ * Handles spaces, quotes, special characters.
+ */
+export function escapeRemotePath(remotePath) {
+    // Use single quotes with escaped single quotes inside
+    // This is the safest way to handle paths with spaces, $, etc.
+    return "'" + remotePath.replace(/'/g, "'\\''") + "'";
+}
+/**
+ * Normalize a local path — handle Windows/Unix differences.
+ */
+export function normalizeLocalPath(localPath) {
+    // Replace forward slashes with OS-appropriate separator on Windows
+    return localPath.replace(/\//g, win32.sep);
+}
+/**
+ * Normalize a remote path — ensure Unix-style.
+ */
+export function normalizeRemotePath(remotePath) {
+    // Remote paths are always Unix-style
+    return remotePath.replace(/\\/g, '/');
+}
+/**
+ * Get parent directory of a remote path.
+ */
+export function remoteDir(remotePath) {
+    return posix.dirname(normalizeRemotePath(remotePath));
+}
+/**
+ * Join remote path segments (Unix-style).
+ */
+export function remoteJoin(...segments) {
+    return posix.join(...segments.map(s => normalizeRemotePath(s)));
+}
+/**
+ * Create remote directory recursively via SFTP.
+ */
+export async function ensureRemoteDir(sftp, dirPath) {
+    const normalized = normalizeRemotePath(dirPath);
+    const parts = normalized.split('/').filter(Boolean);
+    let current = normalized.startsWith('/') ? '/' : '';
+    for (const part of parts) {
+        current = current ? posix.join(current, part) : part;
+        try {
+            await new Promise((resolve, reject) => {
+                sftp.stat(current, (err) => {
+                    if (err) {
+                        sftp.mkdir(current, (mkErr) => {
+                            if (mkErr && mkErr.code !== 4) { // 4 = already exists
+                                reject(mkErr);
+                            }
+                            else {
+                                resolve();
+                            }
+                        });
+                    }
+                    else {
+                        resolve();
+                    }
+                });
+            });
+        }
+        catch (err) {
+            throw new Error(`Failed to create remote directory "${current}": ${err.message}`);
+        }
+    }
+}
+/**
+ * Create local directory recursively.
+ */
+export async function ensureLocalDir(dirPath) {
+    const { mkdir } = await import('fs/promises');
+    await mkdir(dirPath, { recursive: true });
+}
+/**
+ * Check if a remote path exists.
+ */
+export async function remoteExists(sftp, remotePath) {
+    return new Promise((resolve) => {
+        sftp.stat(remotePath, (err) => {
+            resolve(!err);
+        });
+    });
+}
+//# sourceMappingURL=path-utils.js.map

package/dist/utils/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../src/utils/path-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IAC/C,sDAAsD;IACtD,8DAA8D;IAC9D,OAAO,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAChD,mEAAmE;IACnE,OAAO,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IAClD,qCAAqC;IACrC,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,UAAkB;IACxC,OAAO,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAG,QAAkB;IAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,IAAS,EACT,OAAe;IAEf,MAAM,UAAU,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAEpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrD,IAAI,CAAC;YACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACxC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAQ,EAAE,EAAE;oBAC5B,IAAI,GAAG,EAAE,CAAC;wBACN,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,KAAU,EAAE,EAAE;4BAC/B,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,qBAAqB;gCAClD,MAAM,CAAC,KAAK,CAAC,CAAC;4BAClB,CAAC;iCAAM,CAAC;gCACJ,OAAO,EAAE,CAAC;4BACd,CAAC;wBACL,CAAC,CAAC,CAAC;oBACP,CAAC;yBAAM,CAAC;wBACJ,OAAO,EAAE,CAAC;oBACd,CAAC;gBACL,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACtF,CAAC;IACL,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe;IAChD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAS,EAAE,UAAkB;IAC5D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,GAAQ,EAAE,EAAE;YAC/B,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+    "name": "@thesashadev/ssh-mcp-server",
+    "version": "1.0.0",
+    "description": "Professional SSH MCP server for AI agents. Supports sync/async commands, high-performance file transfers with 5 fallbacks.",
+    "license": "AGPL-3.0",
+    "type": "module",
+    "main": "dist/index.js",
+    "bin": {
+        "@thesashadev/ssh-mcp-server": "./dist/index.js",
+        "ssh-mcp-server": "./dist/index.js"
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE",
+        "ssh-servers.example.json"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "start": "node dist/index.js",
+        "dev": "tsx src/index.ts"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.12.1",
+        "ssh2": "^1.16.0",
+        "zod": "^3.25.23"
+    },
+    "devDependencies": {
+        "@types/node": "^22.15.0",
+        "@types/ssh2": "^1.15.4",
+        "tsx": "^4.19.0",
+        "typescript": "^5.8.3"
+    }
+}

package/ssh-servers.example.json

@@ -0,0 +1,29 @@
+{
+    "servers": [
+        {
+            "id": "dev",
+            "name": "Dev Server",
+            "host": "192.168.1.100",
+            "port": 22,
+            "username": "ubuntu",
+            "password": "your-password",
+            "defaultRemoteDir": "/home/ubuntu",
+            "workspaces": [
+                "D:\\projects\\my-app"
+            ]
+        },
+        {
+            "id": "prod",
+            "name": "Production",
+            "host": "10.0.0.5",
+            "port": 22,
+            "username": "deploy",
+            "privateKeyPath": "C:\\Users\\you\\.ssh\\id_rsa",
+            "passphrase": "",
+            "defaultRemoteDir": "/var/www",
+            "workspaces": [
+                "D:\\projects\\production-app"
+            ]
+        }
+    ]
+}