@huzhihui_c/mcp-ssh 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 MCP Forge contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,50 @@
+# @huzhihui_c/mcp-ssh
+
+一个通过 SSH 在远程主机上执行命令的 MCP Server。
+
+## 启动
+
+```bash
+pnpm --filter @huzhihui_c/mcp-ssh build
+pnpm --filter @huzhihui_c/mcp-ssh start
+```
+
+MCP 客户端通常直接启动 npm 包的 bin：
+
+```json
+{
+  "mcpServers": {
+    "ssh": {
+      "command": "npx",
+      "args": ["-y", "@huzhihui_c/mcp-ssh"],
+      "env": {
+        "MCP_SSH_HOST": "example.com",
+        "MCP_SSH_USERNAME": "ubuntu",
+        "MCP_SSH_PRIVATE_KEY_PATH": "C:/Users/you/.ssh/id_ed25519"
+      }
+    }
+  }
+}
+```
+
+也可以在每次调用 `ssh_exec` 时传入 `host`、`username`、`password` 或 `privateKey`。调用参数优先于环境变量。
+
+支持的环境变量：
+
+- `MCP_SSH_HOST`：默认主机。
+- `MCP_SSH_PORT`：默认端口，默认为 `22`。
+- `MCP_SSH_USERNAME`：默认用户名。
+- `MCP_SSH_PASSWORD`：密码认证。
+- `MCP_SSH_PRIVATE_KEY`：私钥内容。
+- `MCP_SSH_PRIVATE_KEY_PATH`：私钥文件路径。
+- `MCP_SSH_PASSPHRASE`：私钥口令。
+- `MCP_SSH_HOST_FINGERPRINT`：必填，服务器的 OpenSSH SHA256 指纹，例如 `SHA256:abc...`。也可以在工具调用中传入 `hostFingerprint`。
+- `MCP_SSH_AUTH_SOCK`：SSH Agent socket；未设置时会尝试使用 `SSH_AUTH_SOCK`。
+
+## 工具
+
+### `ssh_exec`
+
+在远程主机上执行命令。必填参数是 `command` 和服务器 host fingerprint；连接参数可以由调用参数或环境变量提供。
+
+返回标准输出、标准错误和退出码。默认最多返回 1 MiB 输出，可通过 `maxOutputBytes` 调整，上限为 10 MiB。

package/dist/config.d.ts

@@ -0,0 +1,33 @@
+export interface SshToolInput {
+    host?: string;
+    port?: number;
+    username?: string;
+    password?: string;
+    privateKey?: string;
+    passphrase?: string;
+    hostFingerprint?: string;
+    command?: string;
+    cwd?: string;
+    timeoutMs?: number;
+    maxOutputBytes?: number;
+}
+export interface SshConnectionOptions {
+    host: string;
+    port: number;
+    username: string;
+    password?: string;
+    privateKey?: string;
+    passphrase?: string;
+    hostFingerprint: string;
+    agent?: string;
+    readyTimeout: number;
+}
+export declare class SshConfigurationError extends Error {
+    constructor(message: string);
+}
+export declare function resolveConnectionOptions(input: SshToolInput): SshConnectionOptions;
+export declare function resolveExecutionLimits(input: SshToolInput): {
+    timeoutMs: number;
+    maxOutputBytes: number;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AA0BD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,YAAY,GAAG,oBAAoB,CAoDlF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB,CAUA"}

package/dist/config.js

@@ -0,0 +1,76 @@
+import { readFileSync } from 'node:fs';
+export class SshConfigurationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SshConfigurationError';
+    }
+}
+function optionalNonEmpty(value) {
+    return value && value.trim().length > 0 ? value : undefined;
+}
+function readPrivateKeyFromEnvironment() {
+    const inlineKey = optionalNonEmpty(process.env.MCP_SSH_PRIVATE_KEY);
+    if (inlineKey) {
+        return inlineKey;
+    }
+    const keyPath = optionalNonEmpty(process.env.MCP_SSH_PRIVATE_KEY_PATH);
+    if (!keyPath) {
+        return undefined;
+    }
+    try {
+        return readFileSync(keyPath, 'utf8');
+    }
+    catch {
+        throw new SshConfigurationError(`Unable to read the private key configured by MCP_SSH_PRIVATE_KEY_PATH: ${keyPath}`);
+    }
+}
+export function resolveConnectionOptions(input) {
+    const host = optionalNonEmpty(input.host) ?? optionalNonEmpty(process.env.MCP_SSH_HOST);
+    const username = optionalNonEmpty(input.username) ?? optionalNonEmpty(process.env.MCP_SSH_USERNAME);
+    const port = input.port ?? Number.parseInt(process.env.MCP_SSH_PORT ?? '22', 10);
+    const timeoutMs = input.timeoutMs ?? Number.parseInt(process.env.MCP_SSH_TIMEOUT_MS ?? '30000', 10);
+    const password = optionalNonEmpty(input.password) ?? optionalNonEmpty(process.env.MCP_SSH_PASSWORD);
+    const privateKey = optionalNonEmpty(input.privateKey) ?? readPrivateKeyFromEnvironment();
+    const passphrase = optionalNonEmpty(input.passphrase) ?? optionalNonEmpty(process.env.MCP_SSH_PASSPHRASE);
+    const hostFingerprint = optionalNonEmpty(input.hostFingerprint) ??
+        optionalNonEmpty(process.env.MCP_SSH_HOST_FINGERPRINT);
+    const agent = optionalNonEmpty(process.env.MCP_SSH_AUTH_SOCK) ?? optionalNonEmpty(process.env.SSH_AUTH_SOCK);
+    if (!host) {
+        throw new SshConfigurationError('Missing SSH host. Pass host or set MCP_SSH_HOST.');
+    }
+    if (!username) {
+        throw new SshConfigurationError('Missing SSH username. Pass username or set MCP_SSH_USERNAME.');
+    }
+    if (!Number.isInteger(port) || port < 1 || port > 65_535) {
+        throw new SshConfigurationError('SSH port must be an integer between 1 and 65535.');
+    }
+    if (!Number.isInteger(timeoutMs) || timeoutMs < 1_000 || timeoutMs > 120_000) {
+        throw new SshConfigurationError('timeoutMs must be an integer between 1000 and 120000.');
+    }
+    if (!hostFingerprint) {
+        throw new SshConfigurationError('Missing SSH host fingerprint. Pass hostFingerprint or set MCP_SSH_HOST_FINGERPRINT.');
+    }
+    if (!password && !privateKey && !agent) {
+        throw new SshConfigurationError('Missing SSH authentication. Provide password/privateKey or configure MCP_SSH_PRIVATE_KEY_PATH or SSH_AUTH_SOCK.');
+    }
+    return {
+        host,
+        port,
+        username,
+        ...(password ? { password } : {}),
+        ...(privateKey ? { privateKey } : {}),
+        ...(passphrase ? { passphrase } : {}),
+        hostFingerprint,
+        ...(agent ? { agent } : {}),
+        readyTimeout: timeoutMs,
+    };
+}
+export function resolveExecutionLimits(input) {
+    const timeoutMs = input.timeoutMs ?? Number.parseInt(process.env.MCP_SSH_TIMEOUT_MS ?? '30000', 10);
+    const maxOutputBytes = input.maxOutputBytes ?? 1_048_576;
+    if (!Number.isInteger(maxOutputBytes) || maxOutputBytes < 1 || maxOutputBytes > 10_485_760) {
+        throw new SshConfigurationError('maxOutputBytes must be an integer between 1 and 10485760.');
+    }
+    return { timeoutMs, maxOutputBytes };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+const server = createServer();
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/package-metadata.d.ts

@@ -0,0 +1,2 @@
+export declare const packageVersion: string;
+//# sourceMappingURL=package-metadata.d.ts.map

package/dist/package-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-metadata.d.ts","sourceRoot":"","sources":["../src/package-metadata.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,cAAc,QAA0B,CAAC"}

package/dist/package-metadata.js

@@ -0,0 +1,7 @@
+import { readFileSync } from 'node:fs';
+const packageManifest = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+if (typeof packageManifest.version !== 'string' || packageManifest.version.length === 0) {
+    throw new Error('The package.json version is missing or invalid.');
+}
+export const packageVersion = packageManifest.version;
+//# sourceMappingURL=package-metadata.js.map

package/dist/package-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-metadata.js","sourceRoot":"","sources":["../src/package-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAMvC,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAChC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAC/C,CAAC;AAErB,IAAI,OAAO,eAAe,CAAC,OAAO,KAAK,QAAQ,IAAI,eAAe,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IACxF,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC,OAAO,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwCpE,wBAAgB,YAAY,IAAI,SAAS,CAgGxC"}

package/dist/server.js

@@ -0,0 +1,117 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { resolveConnectionOptions, resolveExecutionLimits } from './config.js';
+import { packageVersion } from './package-metadata.js';
+import { executeSshCommand, testSshConnection } from './ssh-client.js';
+const sshConnectionSchema = {
+    host: z.string().min(1).optional().describe('SSH host; falls back to MCP_SSH_HOST.'),
+    port: z.number().int().min(1).max(65_535).optional().describe('SSH port; defaults to 22.'),
+    username: z.string().min(1).optional().describe('SSH username; falls back to MCP_SSH_USERNAME.'),
+    password: z.string().optional().describe('Password authentication.'),
+    privateKey: z.string().optional().describe('Private key contents for key authentication.'),
+    passphrase: z.string().optional().describe('Passphrase for the private key.'),
+    hostFingerprint: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Expected OpenSSH SHA256 host fingerprint; falls back to MCP_SSH_HOST_FINGERPRINT.'),
+};
+function errorMessage(error) {
+    return error instanceof Error ? error.message : 'Unknown SSH error.';
+}
+function outputText(result) {
+    const sections = [`Exit code: ${result.exitCode}`];
+    if (result.signal) {
+        sections.push(`Signal: ${result.signal}`);
+    }
+    sections.push(`STDOUT:\n${result.stdout || '(empty)'}`);
+    sections.push(`STDERR:\n${result.stderr || '(empty)'}`);
+    return sections.join('\n\n');
+}
+export function createServer() {
+    const server = new McpServer({
+        name: 'mcp-ssh',
+        version: packageVersion,
+    });
+    server.registerTool('ssh_exec', {
+        title: 'Execute an SSH command',
+        description: 'Connect to a remote host over SSH and execute one command. Connection credentials can be supplied per call or through MCP_SSH_* environment variables.',
+        inputSchema: {
+            ...sshConnectionSchema,
+            command: z.string().min(1).describe('The shell command to execute remotely.'),
+            cwd: z.string().min(1).optional().describe('Remote working directory.'),
+            timeoutMs: z
+                .number()
+                .int()
+                .min(1_000)
+                .max(120_000)
+                .optional()
+                .describe('Connection and command timeout in milliseconds.'),
+            maxOutputBytes: z
+                .number()
+                .int()
+                .min(1)
+                .max(10_485_760)
+                .optional()
+                .describe('Maximum combined stdout and stderr size; defaults to 1 MiB.'),
+        },
+    }, async (input) => {
+        try {
+            const args = input;
+            const connection = resolveConnectionOptions(args);
+            const limits = resolveExecutionLimits(args);
+            const result = await executeSshCommand({
+                connection,
+                command: args.command,
+                ...limits,
+                ...(args.cwd ? { cwd: args.cwd } : {}),
+            });
+            return {
+                content: [{ type: 'text', text: outputText(result) }],
+                isError: result.exitCode !== 0,
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: 'text', text: `SSH execution failed: ${errorMessage(error)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool('ssh_test_connection', {
+        title: 'Test an SSH connection',
+        description: 'Verify SSH credentials and connectivity without executing a remote command.',
+        inputSchema: {
+            ...sshConnectionSchema,
+            timeoutMs: z
+                .number()
+                .int()
+                .min(1_000)
+                .max(120_000)
+                .optional()
+                .describe('Connection timeout in milliseconds.'),
+        },
+    }, async (input) => {
+        try {
+            const args = input;
+            const connection = resolveConnectionOptions(args);
+            const { timeoutMs } = resolveExecutionLimits(args);
+            await testSshConnection(connection, timeoutMs);
+            return {
+                content: [{ type: 'text', text: 'SSH connection succeeded.' }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: 'text', text: `SSH connection failed: ${errorMessage(error)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/ssh-client.d.ts

@@ -0,0 +1,20 @@
+import type { SshConnectionOptions } from './config.js';
+export interface ExecuteOptions {
+    connection: SshConnectionOptions;
+    command: string;
+    cwd?: string;
+    timeoutMs: number;
+    maxOutputBytes: number;
+}
+export interface ExecuteResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    signal?: string;
+}
+export declare class SshExecutionError extends Error {
+    constructor(message: string);
+}
+export declare function executeSshCommand(options: ExecuteOptions): Promise<ExecuteResult>;
+export declare function testSshConnection(connection: SshConnectionOptions, timeoutMs: number): Promise<void>;
+//# sourceMappingURL=ssh-client.d.ts.map

package/dist/ssh-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-client.d.ts","sourceRoot":"","sources":["../src/ssh-client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,oBAAoB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAoHD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA4BvF;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,oBAAoB,EAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/ssh-client.js

@@ -0,0 +1,139 @@
+import { createHash } from 'node:crypto';
+import { Client } from 'ssh2';
+export class SshExecutionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SshExecutionError';
+    }
+}
+function shellQuote(value) {
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+function commandWithWorkingDirectory(command, cwd) {
+    return cwd ? `cd ${shellQuote(cwd)} && ${command}` : command;
+}
+function fingerprintForHostKey(key) {
+    const digest = createHash('sha256').update(key).digest('base64').replace(/=+$/, '');
+    return `SHA256:${digest}`;
+}
+function normalizedFingerprint(value) {
+    const trimmed = value.trim();
+    return trimmed.startsWith('SHA256:') ? trimmed : `SHA256:${trimmed}`;
+}
+function connectConfig(connection, timeoutMs) {
+    const { hostFingerprint, ...sshConnection } = connection;
+    const expectedFingerprint = normalizedFingerprint(hostFingerprint);
+    return {
+        ...sshConnection,
+        readyTimeout: timeoutMs,
+        hostVerifier: (key) => fingerprintForHostKey(key) === expectedFingerprint,
+    };
+}
+function appendChunk(chunks, chunk, state, maxOutputBytes) {
+    state.bytes += chunk.byteLength;
+    if (state.bytes > maxOutputBytes) {
+        throw new SshExecutionError(`Remote command output exceeded ${maxOutputBytes} bytes.`);
+    }
+    chunks.push(chunk);
+}
+function execOnClient(client, command, timeoutMs, maxOutputBytes) {
+    return new Promise((resolve, reject) => {
+        let channel;
+        let settled = false;
+        const stdout = [];
+        const stderr = [];
+        const outputState = { bytes: 0 };
+        const finish = (callback) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(timer);
+            callback();
+        };
+        const timer = setTimeout(() => {
+            channel?.close();
+            finish(() => reject(new SshExecutionError(`Remote command timed out after ${timeoutMs} ms.`)));
+        }, timeoutMs);
+        client.exec(command, (error, nextChannel) => {
+            if (error) {
+                finish(() => reject(new SshExecutionError(`Unable to start remote command: ${error.message}`)));
+                return;
+            }
+            channel = nextChannel;
+            channel.on('data', (chunk) => {
+                try {
+                    appendChunk(stdout, chunk, outputState, maxOutputBytes);
+                }
+                catch (chunkError) {
+                    channel?.close();
+                    finish(() => reject(chunkError));
+                }
+            });
+            channel.stderr.on('data', (chunk) => {
+                try {
+                    appendChunk(stderr, chunk, outputState, maxOutputBytes);
+                }
+                catch (chunkError) {
+                    channel?.close();
+                    finish(() => reject(chunkError));
+                }
+            });
+            channel.once('error', (channelError) => {
+                finish(() => reject(new SshExecutionError(`SSH channel error: ${channelError.message}`)));
+            });
+            channel.once('close', (code, signal) => {
+                finish(() => resolve({
+                    stdout: Buffer.concat(stdout).toString('utf8'),
+                    stderr: Buffer.concat(stderr).toString('utf8'),
+                    exitCode: code ?? (signal ? 1 : 0),
+                    ...(signal ? { signal } : {}),
+                }));
+            });
+        });
+    });
+}
+export async function executeSshCommand(options) {
+    const client = new Client();
+    try {
+        await new Promise((resolve, reject) => {
+            const onReady = () => {
+                client.removeListener('error', onError);
+                resolve();
+            };
+            const onError = (error) => {
+                client.removeListener('ready', onReady);
+                reject(new SshExecutionError(`SSH connection failed: ${error.message}`));
+            };
+            client.once('ready', onReady);
+            client.once('error', onError);
+            client.connect(connectConfig(options.connection, options.timeoutMs));
+        });
+        return await execOnClient(client, commandWithWorkingDirectory(options.command, options.cwd), options.timeoutMs, options.maxOutputBytes);
+    }
+    finally {
+        client.end();
+    }
+}
+export async function testSshConnection(connection, timeoutMs) {
+    const client = new Client();
+    try {
+        await new Promise((resolve, reject) => {
+            const onReady = () => {
+                client.removeListener('error', onError);
+                resolve();
+            };
+            const onError = (error) => {
+                client.removeListener('ready', onReady);
+                reject(new SshExecutionError(`SSH connection failed: ${error.message}`));
+            };
+            client.once('ready', onReady);
+            client.once('error', onError);
+            client.connect(connectConfig(connection, timeoutMs));
+        });
+    }
+    finally {
+        client.end();
+    }
+}
+//# sourceMappingURL=ssh-client.js.map

package/dist/ssh-client.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@huzhihui_c/mcp-ssh",
+  "version": "1.0.0",
+  "description": "An MCP server for executing commands over SSH.",
+  "type": "module",
+  "exports": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "mcp-ssh": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "node -e \"import('node:fs').then(({rmSync}) => rmSync('dist', { recursive: true, force: true }))\"",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "pnpm build",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "ssh2": "^1.16.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/ssh2": "^1.15.5",
+    "tsx": "^4.19.4"
+  }
+}