mcp-ssh-terminal 0.2.0

package/dist/session.js

@@ -0,0 +1,231 @@
+import { spawn } from "node-pty";
+// @xterm/headless is a CJS bundle whose named exports are not statically
+// detectable by Node's ESM loader, so import the default and destructure.
+import xtermPkg from "@xterm/headless";
+const { Terminal } = xtermPkg;
+// Measured in UTF-16 code units (== bytes for ASCII terminal traffic).
+const MAX_RAW_BYTES = 512 * 1024;
+/**
+ * One persistent child process (typically the ssh client) attached to a PTY,
+ * with its output fed into a headless xterm emulator so callers can read a
+ * rendered screen instead of a raw escape-code stream.
+ */
+export class Session {
+    id;
+    label;
+    startedAt = Date.now();
+    pty;
+    term;
+    raw = "";
+    lastDataAt = Date.now();
+    /** Bumped only by child output, never by our own writes. */
+    dataEvents = 0;
+    _exited = false;
+    _exitCode = null;
+    _exitSignal = null;
+    constructor(id, opts) {
+        this.id = id;
+        this.label = opts.label;
+        this.term = new Terminal({
+            cols: opts.cols,
+            rows: opts.rows,
+            scrollback: opts.scrollback ?? 5000,
+            allowProposedApi: true,
+        });
+        this.pty = spawn(opts.file, opts.args, {
+            name: "xterm-256color",
+            cols: opts.cols,
+            rows: opts.rows,
+            cwd: process.cwd(),
+            env: { ...process.env, TERM: "xterm-256color" },
+        });
+        this.pty.onData((data) => {
+            this.lastDataAt = Date.now();
+            this.dataEvents++;
+            this.term.write(data);
+            this.raw += data;
+            if (this.raw.length > MAX_RAW_BYTES) {
+                this.raw = this.raw.slice(this.raw.length - MAX_RAW_BYTES);
+            }
+        });
+        // The emulator generates replies to terminal queries from the remote side
+        // (cursor-position reports, device attributes, ...). They must be written
+        // back to the child, or programs that probe the terminal hang waiting.
+        // This fires from xterm's async parse loop — outside any tool-call
+        // try/catch — so a write to a just-died PTY must not crash the server.
+        this.term.onData((data) => {
+            if (this._exited)
+                return;
+            try {
+                this.pty.write(data);
+            }
+            catch {
+                /* pty torn down between the exit and onExit firing */
+            }
+        });
+        this.pty.onExit(({ exitCode, signal }) => {
+            this._exited = true;
+            this._exitCode = exitCode;
+            this._exitSignal = signal ?? null;
+            this.lastDataAt = Date.now();
+        });
+    }
+    get exited() {
+        return this._exited;
+    }
+    get exitCode() {
+        return this._exitCode;
+    }
+    get exitSignal() {
+        return this._exitSignal;
+    }
+    get pid() {
+        return this.pty.pid;
+    }
+    get dimensions() {
+        return { cols: this.term.cols, rows: this.term.rows };
+    }
+    /** True while the remote app has DECCKM (application cursor keys) enabled. */
+    get applicationCursorKeys() {
+        return this.term.modes.applicationCursorKeysMode;
+    }
+    /** Write raw bytes to the PTY. Marks activity so idle-waits behave. */
+    write(data) {
+        if (this._exited)
+            throw new Error(`Session ${this.id} has exited`);
+        this.lastDataAt = Date.now();
+        this.pty.write(data);
+    }
+    resize(cols, rows) {
+        if (this._exited)
+            throw new Error(`Session ${this.id} has exited`);
+        this.pty.resize(cols, rows);
+        this.term.resize(cols, rows);
+    }
+    /**
+     * Wait until the output has been quiet for `settleMs`, or `timeoutMs`
+     * elapses, or the process exits — whichever comes first. This is how we
+     * decide a command's output has "settled" enough to read.
+     *
+     * With `requireData`, the settle clock only counts once the child has
+     * produced at least one byte of output — so a slow connection (DNS, TCP,
+     * key exchange) isn't mistaken for an already-settled screen.
+     */
+    waitForIdle(settleMs, timeoutMs, requireData = false) {
+        const deadline = Date.now() + timeoutMs;
+        return new Promise((resolve) => {
+            const tick = () => {
+                if (this._exited)
+                    return resolve({ reason: "exited" });
+                const now = Date.now();
+                if (requireData && this.dataEvents === 0) {
+                    if (now >= deadline)
+                        return resolve({ reason: "timeout" });
+                    return void setTimeout(tick, Math.max(10, Math.min(50, deadline - now)));
+                }
+                const quietFor = now - this.lastDataAt;
+                if (quietFor >= settleMs)
+                    return resolve({ reason: "idle" });
+                if (now >= deadline)
+                    return resolve({ reason: "timeout" });
+                const nextQuiet = this.lastDataAt + settleMs - now;
+                const nextDeadline = deadline - now;
+                setTimeout(tick, Math.max(10, Math.min(nextQuiet, nextDeadline)));
+            };
+            setTimeout(tick, Math.max(10, Math.min(settleMs, timeoutMs)));
+        });
+    }
+    /**
+     * Wait for *new* child output (any byte after this call), the process
+     * exiting, or `timeoutMs` — whichever comes first. Unlike waitForIdle, an
+     * already-quiet session blocks here until something actually arrives.
+     */
+    waitForData(timeoutMs) {
+        const baseline = this.dataEvents;
+        const deadline = Date.now() + timeoutMs;
+        return new Promise((resolve) => {
+            const tick = () => {
+                if (this.dataEvents > baseline)
+                    return resolve({ reason: "data" });
+                if (this._exited)
+                    return resolve({ reason: "exited" });
+                const now = Date.now();
+                if (now >= deadline)
+                    return resolve({ reason: "timeout" });
+                setTimeout(tick, Math.max(10, Math.min(25, deadline - now)));
+            };
+            tick();
+        });
+    }
+    /** Flush the xterm write queue so a subsequent render sees all output. */
+    flush() {
+        return new Promise((resolve) => this.term.write("", () => resolve()));
+    }
+    /**
+     * Render the emulated screen as text. Returns the tail of the buffer down
+     * to the bottom of the viewport (not just the cursor line — full-screen
+     * apps often leave the cursor mid-screen with content below it), capped at
+     * `maxLines`. Trailing blank lines are trimmed. This collapses
+     * redraws/colors/cursor moves into the plain text a human would see.
+     */
+    async render(maxLines) {
+        await this.flush();
+        const buf = this.term.buffer.active;
+        let lastRow = Math.min(buf.baseY + this.term.rows - 1, buf.length - 1);
+        const absCursorRow = buf.baseY + buf.cursorY;
+        // Skip trailing blank viewport rows (typical after a full-screen app
+        // exits) so a small maxLines window isn't spent on empty space — but
+        // never trim above the cursor line.
+        const isBlank = (i) => {
+            const line = buf.getLine(i);
+            return !line || line.translateToString(true) === "";
+        };
+        while (lastRow > absCursorRow && isBlank(lastRow))
+            lastRow--;
+        const start = Math.max(0, lastRow - maxLines + 1);
+        const lines = [];
+        for (let i = start; i <= lastRow; i++) {
+            const line = buf.getLine(i);
+            lines.push(line ? line.translateToString(true) : "");
+        }
+        while (lines.length > 0 && lines[lines.length - 1] === "")
+            lines.pop();
+        // Cursor row relative to the returned text block (buf.cursorY is
+        // viewport-relative and would drift when scrollback lines are shown).
+        return {
+            text: lines.join("\n"),
+            cursorRow: Math.max(0, absCursorRow - start),
+            cursorCol: buf.cursorX,
+            rows: this.term.rows,
+            cols: this.term.cols,
+            totalLines: buf.length,
+            shownLines: lines.length,
+        };
+    }
+    /** Return the tail of the raw PTY byte stream (escape codes included). */
+    rawTail(maxBytes) {
+        if (maxBytes >= this.raw.length)
+            return this.raw;
+        return this.raw.slice(this.raw.length - maxBytes);
+    }
+    /** Terminate the child. SIGHUP first; caller may escalate. */
+    close(signal = "SIGHUP") {
+        if (this._exited)
+            return;
+        try {
+            this.pty.kill(signal);
+        }
+        catch {
+            /* already gone */
+        }
+    }
+    kill() {
+        try {
+            this.pty.kill("SIGKILL");
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/sshConfig.d.ts

@@ -0,0 +1,23 @@
+/** Expand a leading ~ to the user's home directory. */
+export declare function expandHome(p: string): string;
+export interface HostEntry {
+    /** The Host pattern(s) on the entry line, e.g. "prod-web" or "*.internal". */
+    patterns: string[];
+    /** Resolved HostName if the entry sets one. */
+    hostName?: string;
+    /** Resolved User if the entry sets one. */
+    user?: string;
+    /** Resolved Port if the entry sets one. */
+    port?: string;
+    /** ProxyJump target if the entry sets one. */
+    proxyJump?: string;
+    /** File this entry was found in. */
+    source: string;
+}
+/**
+ * Best-effort parser for ~/.ssh/config, following `Include` directives. This
+ * is only for discoverability (listing candidate host aliases) — actual
+ * connection semantics are always delegated to the real ssh client, which is
+ * the authority on config resolution, Match blocks, tokens, etc.
+ */
+export declare function listConfigHosts(configPath?: string): HostEntry[];

package/dist/sshConfig.js

@@ -0,0 +1,95 @@
+import { readFileSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import { globSync } from "node:fs";
+/** Expand a leading ~ to the user's home directory. */
+export function expandHome(p) {
+    if (p === "~")
+        return homedir();
+    if (p.startsWith("~/"))
+        return join(homedir(), p.slice(2));
+    return p;
+}
+/**
+ * Best-effort parser for ~/.ssh/config, following `Include` directives. This
+ * is only for discoverability (listing candidate host aliases) — actual
+ * connection semantics are always delegated to the real ssh client, which is
+ * the authority on config resolution, Match blocks, tokens, etc.
+ */
+export function listConfigHosts(configPath) {
+    const start = configPath ? expandHome(configPath) : join(homedir(), ".ssh", "config");
+    const entries = [];
+    const seen = new Set();
+    const parseFile = (path) => {
+        const abs = resolve(path);
+        if (seen.has(abs))
+            return;
+        seen.add(abs);
+        if (!existsSync(abs))
+            return;
+        let content;
+        try {
+            content = readFileSync(abs, "utf8");
+        }
+        catch {
+            return;
+        }
+        let current = null;
+        const flush = () => {
+            if (current)
+                entries.push(current);
+            current = null;
+        };
+        for (const rawLine of content.split(/\r?\n/)) {
+            const line = rawLine.trim();
+            if (line === "" || line.startsWith("#"))
+                continue;
+            const eq = line.replace(/^(\S+)\s*=\s*/, "$1 ");
+            const spaceIdx = eq.search(/\s/);
+            if (spaceIdx === -1)
+                continue;
+            const keyword = eq.slice(0, spaceIdx).toLowerCase();
+            const value = eq.slice(spaceIdx + 1).trim();
+            if (keyword === "host") {
+                flush();
+                current = { patterns: value.split(/\s+/), source: abs };
+            }
+            else if (keyword === "match") {
+                // A Match block ends the current Host entry. We don't model Match
+                // conditions (ssh itself is the authority) — but without this, the
+                // block's directives would be misattributed to the previous Host.
+                flush();
+            }
+            else if (keyword === "include") {
+                // Includes may reference multiple space-separated glob patterns.
+                for (const token of value.split(/\s+/)) {
+                    const target = expandHome(token);
+                    const globbed = isAbsolute(target) ? target : join(dirname(abs), target);
+                    try {
+                        for (const f of globSync(globbed))
+                            parseFile(f);
+                    }
+                    catch {
+                        /* ignore unmatched includes */
+                    }
+                }
+            }
+            else if (current) {
+                if (keyword === "hostname")
+                    current.hostName = value;
+                else if (keyword === "user")
+                    current.user = value;
+                else if (keyword === "port")
+                    current.port = value;
+                else if (keyword === "proxyjump")
+                    current.proxyJump = value;
+            }
+        }
+        flush();
+    };
+    parseFile(start);
+    // Exclude pure-wildcard catch-all entries from the listing — they're not
+    // connectable destinations, just default blocks.
+    return entries.filter((e) => e.patterns.some((p) => p !== "*" && !p.startsWith("!")));
+}
+//# sourceMappingURL=sshConfig.js.map

package/dist/sshConfig.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "mcp-ssh-terminal",
+  "version": "0.2.0",
+  "description": "MCP server exposing persistent, interactive SSH sessions driven through the real OpenSSH client and a headless terminal emulator.",
+  "bin": {
+    "mcp-ssh-terminal": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "dev": "tsc -p tsconfig.json && node dist/index.js",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "mcp",
+    "ssh",
+    "terminal",
+    "routeros",
+    "mikrotik"
+  ],
+  "author": "Kirill Zhdanov",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhdkirill/mcp-ssh-terminal.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zhdkirill/mcp-ssh-terminal/issues"
+  },
+  "homepage": "https://github.com/zhdkirill/mcp-ssh-terminal#readme",
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@xterm/headless": "^6.0.0",
+    "node-pty": "^1.1.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.1",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  }
+}