ssh-mcp 1.0.8 → 1.1.0

package/README.md

@@ -48,6 +48,10 @@
     - Timeout is configured via command line argument `--timeout` (in milliseconds)
     - Default timeout: 60000ms (1 minute)
     - When a command times out, the server automatically attempts to abort the running process before closing the connection
+  - **Max Command Length Configuration:**
+    - Max command characters are configured via `--maxChars`
+    - Default: `1000`
+    - No-limit mode: set `--maxChars=none` or any `<= 0` value (e.g. `--maxChars=0`)
 
 ## Installation
 
@@ -74,6 +78,7 @@ You can configure Claude Desktop to use this MCP Server.
 - `password`: SSH password (or use `key` for key-based auth)
 - `key`: Path to private SSH key
 - `timeout`: Command execution timeout in milliseconds (default: 60000ms = 1 minute)
+- `maxChars`: Maximum allowed characters for the `command` input (default: 1000). Use `none` or `0` to disable the limit.
 
 
 ```commandline
@@ -90,7 +95,8 @@ You can configure Claude Desktop to use this MCP Server.
                 "--user=root",
                 "--password=pass",
                 "--key=path/to/key",
-                "--timeout=30000"
+                "--timeout=30000",
+                "--maxChars=none"
             ]
         }
     }

package/build/index.js

@@ -16,13 +16,35 @@ function parseArgv() {
     }
     return config;
 }
-const argvConfig = parseArgv();
+const isCliEnabled = process.env.SSH_MCP_DISABLE_MAIN !== '1';
+const argvConfig = isCliEnabled ? parseArgv() : {};
 const HOST = argvConfig.host;
 const PORT = argvConfig.port ? parseInt(argvConfig.port) : 22;
 const USER = argvConfig.user;
 const PASSWORD = argvConfig.password;
 const KEY = argvConfig.key;
 const DEFAULT_TIMEOUT = argvConfig.timeout ? parseInt(argvConfig.timeout) : 60000; // 60 seconds default timeout
+// Max characters configuration:
+// - Default: 1000 characters
+// - When set via --maxChars:
+//   * a positive integer enforces that limit
+//   * 0 or a negative value disables the limit (no max)
+//   * the string "none" (case-insensitive) disables the limit (no max)
+const MAX_CHARS_RAW = argvConfig.maxChars;
+const MAX_CHARS = (() => {
+    if (typeof MAX_CHARS_RAW === 'string') {
+        const lowered = MAX_CHARS_RAW.toLowerCase();
+        if (lowered === 'none')
+            return Infinity;
+        const parsed = parseInt(MAX_CHARS_RAW);
+        if (isNaN(parsed))
+            return 1000;
+        if (parsed <= 0)
+            return Infinity;
+        return parsed;
+    }
+    return 1000;
+})();
 function validateConfig(config) {
     const errors = [];
     if (!config.host)
@@ -35,9 +57,11 @@ function validateConfig(config) {
         throw new Error('Configuration error:\n' + errors.join('\n'));
     }
 }
-validateConfig(argvConfig);
+if (isCliEnabled) {
+    validateConfig(argvConfig);
+}
 // Command sanitization and validation
-function sanitizeCommand(command) {
+export function sanitizeCommand(command) {
     if (typeof command !== 'string') {
         throw new McpError(ErrorCode.InvalidParams, 'Command must be a string');
     }
@@ -46,19 +70,19 @@ function sanitizeCommand(command) {
         throw new McpError(ErrorCode.InvalidParams, 'Command cannot be empty');
     }
     // Length check
-    if (trimmedCommand.length > 1000) {
-        throw new McpError(ErrorCode.InvalidParams, 'Command is too long (max 1000 characters)');
+    if (Number.isFinite(MAX_CHARS) && trimmedCommand.length > MAX_CHARS) {
+        throw new McpError(ErrorCode.InvalidParams, `Command is too long (max ${MAX_CHARS} characters)`);
     }
     return trimmedCommand;
 }
 // Escape command for use in shell contexts (like pkill)
-function escapeCommandForShell(command) {
+export function escapeCommandForShell(command) {
     // Replace single quotes with escaped single quotes
     return command.replace(/'/g, "'\"'\"'");
 }
 const server = new McpServer({
     name: 'SSH MCP Server',
-    version: '1.0.7',
+    version: '1.0.9',
     capabilities: {
         resources: {},
         tools: {},
@@ -92,7 +116,7 @@ server.tool("exec", "Execute a shell command on the remote SSH server and return
         throw new McpError(ErrorCode.InternalError, `Unexpected error: ${err?.message || err}`);
     }
 });
-async function execSshCommand(sshConfig, command) {
+export async function execSshCommand(sshConfig, command) {
     return new Promise((resolve, reject) => {
         const conn = new SSHClient();
         let timeoutId;
@@ -175,7 +199,10 @@ async function main() {
     await server.connect(transport);
     console.error("SSH MCP Server running on stdio");
 }
-main().catch((error) => {
-    console.error("Fatal error in main():", error);
-    process.exit(1);
-});
+if (process.env.SSH_MCP_DISABLE_MAIN !== '1') {
+    main().catch((error) => {
+        console.error("Fatal error in main():", error);
+        process.exit(1);
+    });
+}
+export { parseArgv, validateConfig };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ssh-mcp",
   "license": "MIT",
-  "version": "1.0.8",
+  "version": "1.1.0",
   "description": "MCP server exposing SSH control for Linux and Windows systems via Model Context Protocol.",
   "type": "module",
   "bin": {
@@ -10,7 +10,10 @@
   "scripts": {
     "prepare": "npm run build",
     "build": "tsc && shx chmod +x build/*.js",
-    "inspect": "npx @modelcontextprotocol/inspector node build/index.js"
+    "inspect": "npx @modelcontextprotocol/inspector node build/index.js",
+    "test": "cross-env SSH_MCP_DISABLE_MAIN=1 vitest --run",
+    "test:watch": "cross-env SSH_MCP_DISABLE_MAIN=1 vitest",
+    "coverage": "cross-env SSH_MCP_DISABLE_MAIN=1 vitest --run --coverage"
   },
   "files": [
     "build"
@@ -18,13 +21,18 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.17.5",
     "ssh2": "^1.17.0",
-    "zod": "^4.1.5"
+    "zod": "3.23.8"
   },
   "devDependencies": {
-    "@types/node": "^24.3.0",
+    "@types/node": "^24.5.2",
     "@types/ssh2": "^1.15.5",
+    "cross-env": "^7.0.3",
     "shx": "^0.4.0",
-    "typescript": "^5.9.2"
+    "testcontainers": "^11.7.0",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
   },
   "homepage": "https://github.com/tufantunc/ssh-mcp#readme",
   "repository": {