@jadchene/mcp-ssh-service 1.4.0 → 1.4.1

package/README.md

@@ -193,12 +193,14 @@ args = ["--config", "./config.json"]
 * `execute_command` [Auth Required, single command only]
 * `echo`
 
-### File Management (15)
+### File Management (17)
 * `upload_file` [Auth Required]
 * `download_file`
 * `ll`
 * `cat`
+* `head`
 * `tail`
+* `sed`
 * `grep`
 * `edit_text_file` [Auth Required]
 * `touch`
@@ -272,7 +274,7 @@ args = ["--config", "./config.json"]
 * `zip` [Auth Required]
 * `unzip` [Auth Required]
 
-Total: 79 tools.
+Total: 81 tools.
 
 ---
 

package/dist/tools/definitions.js

@@ -115,11 +115,26 @@ export const toolDefinitions = [
         description: 'File reading: Reads text file content.',
         inputSchema: baseParams({ filePath: { type: 'string' }, ...grepParam }, ['filePath'])
     },
+    {
+        name: 'head',
+        description: 'File preview: Reads the first N lines of a file.',
+        inputSchema: baseParams({ filePath: { type: 'string' }, lines: { type: 'number' }, ...grepParam }, ['filePath'])
+    },
     {
         name: 'tail',
         description: 'Log inspection: Reads last N lines of a file.',
         inputSchema: baseParams({ filePath: { type: 'string' }, lines: { type: 'number' }, ...grepParam }, ['filePath'])
     },
+    {
+        name: 'sed',
+        description: 'Line range reading: Reads an inclusive line range from a text file.',
+        inputSchema: baseParams({
+            filePath: { type: 'string' },
+            startLine: { type: 'number' },
+            endLine: { type: 'number' },
+            ...grepParam
+        }, ['filePath', 'startLine', 'endLine'])
+    },
     {
         name: 'grep',
         description: 'Pattern search: Search for a regex pattern in a file.',

package/dist/tools/handlers.js

@@ -117,6 +117,14 @@ export class ToolHandlers {
             this.validateShellToken(value, `${fieldName}[${index}]`);
         }
     }
+    /**
+     * Validate positive line counts for text inspection helpers.
+     */
+    validatePositiveInteger(value, fieldName) {
+        if (!Number.isInteger(value) || value <= 0) {
+            throw new Error(`${fieldName} must be a positive integer.`);
+        }
+    }
     escapePerlEnvBase64(value) {
         return Buffer.from(value).toString('base64');
     }
@@ -212,6 +220,16 @@ export class ToolHandlers {
         if ((name === 'netstat' || name === 'ss') && Array.isArray(params.args)) {
             this.validateTokenArray(params.args, `${name}.args`);
         }
+        if ((name === 'head' || name === 'tail') && params.lines !== undefined) {
+            this.validatePositiveInteger(params.lines, `${name}.lines`);
+        }
+        if (name === 'sed') {
+            this.validatePositiveInteger(params.startLine, 'sed.startLine');
+            this.validatePositiveInteger(params.endLine, 'sed.endLine');
+            if (params.endLine < params.startLine) {
+                throw new Error(`sed.endLine must be greater than or equal to sed.startLine.`);
+            }
+        }
         if (name === 'docker_exec' && Array.isArray(params.args)) {
             for (const [index, arg] of params.args.entries()) {
                 this.validateShellFragment(arg, `docker_exec.args[${index}]`);
@@ -241,7 +259,9 @@ export class ToolHandlers {
             case 'cd': return `cd ${this.shellEscape(params.path)}`;
             case 'll': return 'ls -l';
             case 'cat': return `cat ${this.shellEscape(params.filePath)}`;
+            case 'head': return `head -n ${params.lines || 40} ${this.shellEscape(params.filePath)}`;
             case 'tail': return `tail -n ${params.lines || 50} ${this.shellEscape(params.filePath)}`;
+            case 'sed': return `sed -n '${params.startLine},${params.endLine}p' ${this.shellEscape(params.filePath)}`;
             case 'grep': return `grep ${params.ignoreCase ? '-inE' : '-nE'} ${this.shellEscape(params.pattern)} ${this.shellEscape(params.filePath)}`;
             case 'edit_text_file':
                 const edB64 = Buffer.from(params.content).toString('base64');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jadchene/mcp-ssh-service",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "A production-ready, highly secure SSH MCP server featuring stateless connections, two-step operation confirmation, and comprehensive DevOps tool integration.",
   "main": "dist/index.js",
   "type": "module",