enterprise-ssh-mcp-server 0.3.0

package/dist/runtime-config.js.map

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

package/dist/session-registry.d.ts

@@ -0,0 +1,9 @@
+import { SshSession, type ConnectInput, type SessionSummary } from "./ssh-session.js";
+export declare class SessionRegistry {
+    private readonly sessions;
+    connect(input: ConnectInput): Promise<SessionSummary>;
+    get(sessionId: string): SshSession;
+    list(): SessionSummary[];
+    disconnect(sessionId: string): Promise<SessionSummary>;
+    disconnectAll(): Promise<SessionSummary[]>;
+}

package/dist/session-registry.js

@@ -0,0 +1,35 @@
+import { McpToolError } from "./tool-result.js";
+import { SshSession } from "./ssh-session.js";
+export class SessionRegistry {
+    sessions = new Map();
+    async connect(input) {
+        const session = await SshSession.connect(input);
+        this.sessions.set(session.id, session);
+        return session.summary();
+    }
+    get(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session === undefined) {
+            throw new McpToolError("ssh_session_not_found", "SSH session id was not found", { sessionId });
+        }
+        return session;
+    }
+    list() {
+        return [...this.sessions.values()].map((session) => session.summary());
+    }
+    async disconnect(sessionId) {
+        const session = this.get(sessionId);
+        const summary = await session.disconnect();
+        this.sessions.delete(sessionId);
+        return summary;
+    }
+    async disconnectAll() {
+        const summaries = [];
+        for (const session of this.sessions.values()) {
+            summaries.push(await session.disconnect());
+        }
+        this.sessions.clear();
+        return summaries;
+    }
+}
+//# sourceMappingURL=session-registry.js.map

package/dist/session-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-registry.js","sourceRoot":"","sources":["../src/session-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAA0C,MAAM,kBAAkB,CAAC;AAEtF,MAAM,OAAO,eAAe;IACT,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEnD,KAAK,CAAC,OAAO,CAAC,KAAmB;QACtC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACvC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAEM,GAAG,CAAC,SAAiB;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,YAAY,CAAC,uBAAuB,EAAE,8BAA8B,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACjG,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEM,IAAI;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,SAAiB;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;QAC3C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAEM,KAAK,CAAC,aAAa;QACxB,MAAM,SAAS,GAAqB,EAAE,CAAC;QACvC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,SAAS,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/sftp-ops.d.ts

@@ -0,0 +1,46 @@
+import type { Attributes, FileEntryWithStats, InputAttributes, SFTPWrapper, Stats } from "ssh2";
+export interface FileAttributesJson {
+    mode: number;
+    modeOctal: string;
+    permissionsOctal: string;
+    uid: number;
+    gid: number;
+    size: number;
+    atime: number;
+    mtime: number;
+}
+export interface FileStatsJson extends FileAttributesJson {
+    type: string;
+}
+export interface DirectoryEntryJson {
+    filename: string;
+    longname: string;
+    attrs: FileStatsJson;
+}
+export interface RemoteReadResult {
+    data: string;
+    encoding: "utf8" | "base64";
+    bytesRead: number;
+    truncated: boolean;
+}
+export type SmallWriteFlag = "w" | "wx" | "a" | "ax";
+export declare function attributesToJson(attrs: Attributes): FileAttributesJson;
+export declare function statsToJson(stats: Stats): FileStatsJson;
+export declare function entryToJson(entry: FileEntryWithStats): DirectoryEntryJson;
+export declare function sftpStat(sftp: SFTPWrapper, remotePath: string, followSymlinks: boolean): Promise<Stats>;
+export declare function sftpReadDir(sftp: SFTPWrapper, remotePath: string): Promise<FileEntryWithStats[]>;
+export declare function sftpMkdir(sftp: SFTPWrapper, remotePath: string, attrs?: InputAttributes): Promise<void>;
+export declare function sftpMkdirRecursive(sftp: SFTPWrapper, remotePath: string, attrs?: InputAttributes): Promise<void>;
+export declare function sftpUnlink(sftp: SFTPWrapper, remotePath: string): Promise<void>;
+export declare function sftpRmdir(sftp: SFTPWrapper, remotePath: string): Promise<void>;
+export declare function sftpRemove(sftp: SFTPWrapper, remotePath: string, recursive: boolean): Promise<void>;
+export declare function sftpRename(sftp: SFTPWrapper, sourcePath: string, destinationPath: string): Promise<void>;
+export declare function sftpChmod(sftp: SFTPWrapper, remotePath: string, mode: number | string): Promise<void>;
+export declare function sftpChown(sftp: SFTPWrapper, remotePath: string, uid: number, gid: number): Promise<void>;
+export declare function sftpUtimes(sftp: SFTPWrapper, remotePath: string, atime: Date, mtime: Date): Promise<void>;
+export declare function sftpReadlink(sftp: SFTPWrapper, remotePath: string): Promise<string>;
+export declare function sftpSymlink(sftp: SFTPWrapper, targetPath: string, linkPath: string): Promise<void>;
+export declare function sftpRealpath(sftp: SFTPWrapper, remotePath: string): Promise<string>;
+export declare function sftpWriteFile(sftp: SFTPWrapper, remotePath: string, data: Buffer, mode: number | undefined, flag: SmallWriteFlag): Promise<void>;
+export declare function sftpReadFileLimited(sftp: SFTPWrapper, remotePath: string, encoding: "utf8" | "base64", maxBytes: number): Promise<RemoteReadResult>;
+export declare function isMissingPathError(error: Error): boolean;

package/dist/sftp-ops.js

@@ -0,0 +1,306 @@
+import { McpToolError } from "./tool-result.js";
+import { joinRemotePath, normalizeRemotePath, splitRemotePath } from "./remote-path.js";
+export function attributesToJson(attrs) {
+    return {
+        mode: attrs.mode,
+        modeOctal: `0${attrs.mode.toString(8)}`,
+        permissionsOctal: `0${(attrs.mode & 0o777).toString(8).padStart(3, "0")}`,
+        uid: attrs.uid,
+        gid: attrs.gid,
+        size: attrs.size,
+        atime: attrs.atime,
+        mtime: attrs.mtime,
+    };
+}
+export function statsToJson(stats) {
+    return {
+        ...attributesToJson(stats),
+        type: classifyStats(stats),
+    };
+}
+export function entryToJson(entry) {
+    return {
+        filename: entry.filename,
+        longname: entry.longname,
+        attrs: statsToJson(entry.attrs),
+    };
+}
+export function sftpStat(sftp, remotePath, followSymlinks) {
+    return new Promise((resolve, reject) => {
+        const callback = (err, stats) => {
+            if (err != null) {
+                reject(wrapSftpError("stat", remotePath, err));
+                return;
+            }
+            resolve(stats);
+        };
+        if (followSymlinks) {
+            sftp.stat(remotePath, callback);
+            return;
+        }
+        sftp.lstat(remotePath, callback);
+    });
+}
+export function sftpReadDir(sftp, remotePath) {
+    return new Promise((resolve, reject) => {
+        sftp.readdir(remotePath, (err, list) => {
+            if (err != null) {
+                reject(wrapSftpError("readdir", remotePath, err));
+                return;
+            }
+            resolve(list);
+        });
+    });
+}
+export function sftpMkdir(sftp, remotePath, attrs) {
+    return new Promise((resolve, reject) => {
+        const callback = (err) => {
+            if (err != null) {
+                reject(wrapSftpError("mkdir", remotePath, err));
+                return;
+            }
+            resolve();
+        };
+        if (attrs !== undefined) {
+            sftp.mkdir(remotePath, attrs, callback);
+            return;
+        }
+        sftp.mkdir(remotePath, callback);
+    });
+}
+export async function sftpMkdirRecursive(sftp, remotePath, attrs) {
+    const normalized = normalizeRemotePath(remotePath);
+    const parts = splitRemotePath(normalized);
+    let current = normalized.startsWith("/") ? "/" : "";
+    for (const part of parts) {
+        current = current === "/" ? `/${part}` : current.length === 0 ? part : joinRemotePath(current, part);
+        try {
+            const stats = await sftpStat(sftp, current, false);
+            if (!stats.isDirectory()) {
+                throw new McpToolError("remote_path_not_directory", "Remote path exists but is not a directory", {
+                    path: current,
+                });
+            }
+        }
+        catch (error) {
+            if (!isMissingPathError(error)) {
+                throw error;
+            }
+            await sftpMkdir(sftp, current, attrs);
+        }
+    }
+}
+export function sftpUnlink(sftp, remotePath) {
+    return new Promise((resolve, reject) => {
+        sftp.unlink(remotePath, (err) => {
+            if (err != null) {
+                reject(wrapSftpError("unlink", remotePath, err));
+                return;
+            }
+            resolve();
+        });
+    });
+}
+export function sftpRmdir(sftp, remotePath) {
+    return new Promise((resolve, reject) => {
+        sftp.rmdir(remotePath, (err) => {
+            if (err != null) {
+                reject(wrapSftpError("rmdir", remotePath, err));
+                return;
+            }
+            resolve();
+        });
+    });
+}
+export async function sftpRemove(sftp, remotePath, recursive) {
+    const stats = await sftpStat(sftp, remotePath, false);
+    if (!stats.isDirectory()) {
+        await sftpUnlink(sftp, remotePath);
+        return;
+    }
+    if (!recursive) {
+        throw new McpToolError("recursive_required", "Remote path is a directory; pass recursive=true to remove it", {
+            path: remotePath,
+        });
+    }
+    const entries = await sftpReadDir(sftp, remotePath);
+    for (const entry of entries) {
+        if (entry.filename === "." || entry.filename === "..") {
+            continue;
+        }
+        await sftpRemove(sftp, joinRemotePath(remotePath, entry.filename), true);
+    }
+    await sftpRmdir(sftp, remotePath);
+}
+export function sftpRename(sftp, sourcePath, destinationPath) {
+    return new Promise((resolve, reject) => {
+        sftp.rename(sourcePath, destinationPath, (err) => {
+            if (err != null) {
+                reject(new McpToolError("sftp_rename_failed", err.message, { sourcePath, destinationPath }));
+                return;
+            }
+            resolve();
+        });
+    });
+}
+export function sftpChmod(sftp, remotePath, mode) {
+    return new Promise((resolve, reject) => {
+        sftp.chmod(remotePath, mode, (err) => {
+            if (err != null) {
+                reject(wrapSftpError("chmod", remotePath, err));
+                return;
+            }
+            resolve();
+        });
+    });
+}
+export function sftpChown(sftp, remotePath, uid, gid) {
+    return new Promise((resolve, reject) => {
+        sftp.chown(remotePath, uid, gid, (err) => {
+            if (err != null) {
+                reject(wrapSftpError("chown", remotePath, err));
+                return;
+            }
+            resolve();
+        });
+    });
+}
+export function sftpUtimes(sftp, remotePath, atime, mtime) {
+    return new Promise((resolve, reject) => {
+        sftp.utimes(remotePath, atime, mtime, (err) => {
+            if (err != null) {
+                reject(wrapSftpError("utimes", remotePath, err));
+                return;
+            }
+            resolve();
+        });
+    });
+}
+export function sftpReadlink(sftp, remotePath) {
+    return new Promise((resolve, reject) => {
+        sftp.readlink(remotePath, (err, target) => {
+            if (err != null) {
+                reject(wrapSftpError("readlink", remotePath, err));
+                return;
+            }
+            resolve(target);
+        });
+    });
+}
+export function sftpSymlink(sftp, targetPath, linkPath) {
+    return new Promise((resolve, reject) => {
+        sftp.symlink(targetPath, linkPath, (err) => {
+            if (err != null) {
+                reject(new McpToolError("sftp_symlink_failed", err.message, { targetPath, linkPath }));
+                return;
+            }
+            resolve();
+        });
+    });
+}
+export function sftpRealpath(sftp, remotePath) {
+    return new Promise((resolve, reject) => {
+        sftp.realpath(remotePath, (err, absolutePath) => {
+            if (err != null) {
+                reject(wrapSftpError("realpath", remotePath, err));
+                return;
+            }
+            resolve(absolutePath);
+        });
+    });
+}
+export function sftpWriteFile(sftp, remotePath, data, mode, flag) {
+    return new Promise((resolve, reject) => {
+        const options = mode === undefined ? { flag } : { flag, mode };
+        sftp.writeFile(remotePath, data, options, (err) => {
+            if (err != null) {
+                reject(wrapSftpError("writeFile", remotePath, err));
+                return;
+            }
+            resolve();
+        });
+    });
+}
+export function sftpReadFileLimited(sftp, remotePath, encoding, maxBytes) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let bytesRead = 0;
+        let resolved = false;
+        let truncated = false;
+        const finish = () => {
+            if (resolved) {
+                return;
+            }
+            resolved = true;
+            const buffer = Buffer.concat(chunks, bytesRead);
+            resolve({
+                data: encoding === "base64" ? buffer.toString("base64") : buffer.toString("utf8"),
+                encoding,
+                bytesRead,
+                truncated,
+            });
+        };
+        const stream = sftp.createReadStream(remotePath);
+        stream.on("data", (chunk) => {
+            if (resolved) {
+                return;
+            }
+            const remaining = maxBytes - bytesRead;
+            if (chunk.length <= remaining) {
+                chunks.push(chunk);
+                bytesRead += chunk.length;
+                return;
+            }
+            if (remaining > 0) {
+                chunks.push(chunk.subarray(0, remaining));
+                bytesRead += remaining;
+            }
+            truncated = true;
+            finish();
+            stream.destroy();
+        });
+        stream.on("end", finish);
+        stream.on("close", finish);
+        stream.on("error", (err) => {
+            if (resolved) {
+                return;
+            }
+            reject(wrapSftpError("readFile", remotePath, err));
+        });
+    });
+}
+export function isMissingPathError(error) {
+    if (error instanceof McpToolError) {
+        return error.code === "sftp_stat_failed" && /no such file|not found|failure/i.test(error.message);
+    }
+    const errno = error;
+    return errno.code === "ENOENT" || /no such file|not found/i.test(error.message);
+}
+function wrapSftpError(action, remotePath, error) {
+    return new McpToolError(`sftp_${action}_failed`, error.message, { action, remotePath });
+}
+function classifyStats(stats) {
+    if (stats.isDirectory()) {
+        return "directory";
+    }
+    if (stats.isFile()) {
+        return "file";
+    }
+    if (stats.isSymbolicLink()) {
+        return "symlink";
+    }
+    if (stats.isBlockDevice()) {
+        return "block_device";
+    }
+    if (stats.isCharacterDevice()) {
+        return "character_device";
+    }
+    if (stats.isFIFO()) {
+        return "fifo";
+    }
+    if (stats.isSocket()) {
+        return "socket";
+    }
+    return "unknown";
+}
+//# sourceMappingURL=sftp-ops.js.map

package/dist/sftp-ops.js.map

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

package/dist/ssh-session.d.ts

@@ -0,0 +1,146 @@
+import { type PseudoTtyOptions, type SFTPWrapper } from "ssh2";
+import { ByteCollector, type WireEncoding } from "./buffers.js";
+export interface ConnectInput {
+    name?: string;
+    host: string;
+    port: number;
+    username: string;
+    password?: string;
+    privateKey?: string;
+    privateKeyPath?: string;
+    passphrase?: string;
+    agent?: string;
+    agentForward: boolean;
+    tryKeyboard: boolean;
+    keyboardResponses: string[];
+    keepaliveIntervalMs: number;
+    keepaliveCountMax: number;
+    readyTimeoutMs: number;
+    connectionTimeoutMs: number;
+    hostHash?: string;
+    expectedHostHash?: string;
+    strictVendor: boolean;
+    debug: boolean;
+}
+export interface SessionSummary {
+    id: string;
+    name?: string;
+    host: string;
+    port: number;
+    username: string;
+    connected: boolean;
+    createdAt: string;
+    lastUsedAt: string;
+    shellCount: number;
+    localTunnelCount: number;
+    remoteTunnelCount: number;
+    lastError?: string;
+}
+export interface ExecInput {
+    command: string;
+    env?: Record<string, string>;
+    stdin?: string;
+    stdinEncoding: WireEncoding;
+    outputEncoding: WireEncoding;
+    timeoutMs: number;
+    maxOutputBytes: number;
+    pty?: PseudoTtyOptions | boolean;
+}
+export interface ExecResult {
+    command: string;
+    exitCode: number | null;
+    signal: string | null;
+    timedOut: boolean;
+    durationMs: number;
+    stdout: ReturnType<ByteCollector["snapshot"]>;
+    stderr: ReturnType<ByteCollector["snapshot"]>;
+}
+export interface ShellOpenInput {
+    env?: Record<string, string>;
+    allocatePty: boolean;
+    pty?: PseudoTtyOptions;
+    ringBufferBytes: number;
+}
+export interface ShellSummary {
+    id: string;
+    openedAt: string;
+    lastUsedAt: string;
+    closed: boolean;
+    bufferedBytes: number;
+    exitCode: number | null;
+    exitSignal: string | null;
+}
+export interface ShellReadInput {
+    shellId: string;
+    maxBytes: number;
+    encoding: WireEncoding;
+    drain: boolean;
+}
+export interface LocalForwardInput {
+    localHost: string;
+    localPort: number;
+    targetHost: string;
+    targetPort: number;
+}
+export interface RemoteForwardInput {
+    remoteHost: string;
+    remotePort: number;
+    targetHost: string;
+    targetPort: number;
+}
+export interface TunnelSummary {
+    id: string;
+    type: "local" | "remote";
+    bindHost: string;
+    bindPort: number;
+    targetHost: string;
+    targetPort: number;
+    openedAt: string;
+    connectionCount: number;
+    lastError?: string;
+}
+export declare class SshSession {
+    readonly id: string;
+    private readonly client;
+    private readonly name?;
+    private readonly host;
+    private readonly port;
+    private readonly username;
+    private readonly createdAt;
+    private readonly shells;
+    private readonly localTunnels;
+    private readonly remoteTunnels;
+    private sftpPromise;
+    private connected;
+    private lastUsedAt;
+    private lastError?;
+    private constructor();
+    static connect(input: ConnectInput): Promise<SshSession>;
+    summary(): SessionSummary;
+    disconnect(): Promise<SessionSummary>;
+    rekey(): Promise<object>;
+    exec(input: ExecInput): Promise<ExecResult>;
+    openShell(input: ShellOpenInput): Promise<ShellSummary>;
+    listShells(): ShellSummary[];
+    writeShell(shellId: string, data: string, encoding: WireEncoding): ShellSummary;
+    readShell(input: ShellReadInput): object;
+    resizeShell(shellId: string, rows: number, cols: number, height: number, width: number): ShellSummary;
+    closeShell(shellId: string): ShellSummary;
+    getSftp(): Promise<SFTPWrapper>;
+    startLocalForward(input: LocalForwardInput): Promise<TunnelSummary>;
+    startRemoteForward(input: RemoteForwardInput): Promise<TunnelSummary>;
+    listTunnels(): TunnelSummary[];
+    stopTunnel(tunnelId: string): Promise<TunnelSummary>;
+    private open;
+    private installConnectionEventHandlers;
+    private ensureConnected;
+    private touch;
+    private getShell;
+    private shellSummary;
+    private handleLocalForwardConnection;
+    private handleRemoteForwardConnection;
+    private stopLocalTunnel;
+    private stopRemoteTunnel;
+    private localTunnelSummary;
+    private remoteTunnelSummary;
+}