it-tools-mcp 3.0.15 → 3.0.16

package/README.dockerhub.md

@@ -4,7 +4,7 @@
 [![Docker Image Size](https://img.shields.io/docker/image-size/wrenchpilot/it-tools-mcp/latest?refresh=1)](https://hub.docker.com/r/wrenchpilot/it-tools-mcp)
 [![Build Status](https://github.com/wrenchpilot/it-tools-mcp/workflows/Build%20and%20Push%20to%20Docker%20Hub/badge.svg)](https://github.com/wrenchpilot/it-tools-mcp/actions)
 
-A comprehensive Model Context Protocol (MCP) server that provides access to **86 IT tools and utilities** commonly used by developers, system administrators, and IT professionals. This server exposes a complete set of tools for encoding/decoding, text manipulation, hashing, network utilities, and many other common development and IT tasks.
+A comprehensive Model Context Protocol (MCP) server that provides access to **87 IT tools and utilities** commonly used by developers, system administrators, and IT professionals. This server exposes a complete set of tools for encoding/decoding, text manipulation, hashing, network utilities, and many other common development and IT tasks.
 
 ## Using with VS Code
 
@@ -56,7 +56,7 @@ Add to your VS Code `settings.json`:
 }
 ```
 
-See the complete list of all 86 tools with detailed parameters on [GitHub](https://github.com/wrenchpilot/it-tools-mcp#available-tools)
+See the complete list of all 87 tools with detailed parameters on [GitHub](https://github.com/wrenchpilot/it-tools-mcp#available-tools)
 
 ## 📸 Examples in Action
 
@@ -78,7 +78,7 @@ Built with **TypeScript**, **Zod** validation, and **MCP SDK** for robust, type-
 
 This project was developed using **VS Code**, **Copilot Chat Agent**, **Playwright MCP**, and the **Claude Sonnet 4 Model**, showcasing modern AI-assisted software development:
 
-- 🔧 **All 86 tools** designed and implemented with AI assistance
+- 🔧 **All 87 tools** designed and implemented with AI assistance
 - 📦 **Complete Docker setup** with GitHub Actions CI/CD pipeline
 - 🔍 **Schema optimization** with systematic validation cleanup
 - 📚 **Comprehensive documentation** and tool catalogs

package/README.md

@@ -171,6 +171,7 @@ Examples of using the IT Tools MCP server with VS Code Copilot Chat for secure p
 | `telnet`                    | Test TCP connectivity                  | `target: string`, `port: number`                                                                                                                                                                          |
 | `dig`                       | DNS query (custom type)                | `target: string`, `type?: string`                                                                                                                                                                         |
 | `ssh`                       | SSH command execution                  | `target: string`, `user: string`, `command: string`                                                                                                                                                       |
+| `scp`                       | Copy files to/from remote host (SFTP)   | `target: string`, `user: string`, `direction: 'upload'\|'download'`, `localPath: string`, `remotePath: string`, `privateKey?: string` |
 | `ip-subnet-calculator`      | Calculate IPv4 subnet                  | `ip: string`, `cidr: number`                                                                                                                                                                              |
 | `ipv4-subnet-calc`          | Enhanced IPv4 subnet calc              | `cidr: string`                                                                                                                                                                                            |
 | `ipv6-ula-generator`        | Generate IPv6 ULA                      | `globalId?: string`                                                                                                                                                                                       |

package/build/tools/network.js

@@ -433,7 +433,7 @@ ${exclude.length > 0 ? `Custom excluded: ${exclude.join(', ')}` : ''}`,
                     throw new Error("Prefix cannot have more than 6 parts");
                 }
                 for (const part of prefixParts) {
-                    if (!/^[0-9A-Fa-f]{2}$/.test(part)) {
+                    if (!/^[0-9-A-Fa-f]{2}$/.test(part)) {
                         throw new Error(`Invalid MAC address part: ${part}`);
                     }
                     macParts.push(part.toUpperCase());
@@ -787,4 +787,99 @@ Common issues:
             return { content: [{ type: "text", text: `tail failed: ${error instanceof Error ? error.message : error}` }] };
         }
     });
+    // SCP Tool (using ssh2 SFTP)
+    server.tool("scp", "Copy files to or from a remote host using SFTP (SCP-like)", {
+        target: z.string().describe("Target host"),
+        user: z.string().describe("Username"),
+        direction: z.enum(["upload", "download"]).describe("Direction: upload (local to remote) or download (remote to local)"),
+        localPath: z.string().describe("Local file path (source for upload, destination for download)"),
+        remotePath: z.string().describe("Remote file path (destination for upload, source for download)"),
+        privateKey: z.string().optional().describe("Private key for authentication (PEM format, optional, or path to key file)")
+    }, async ({ target, user, direction, localPath, remotePath, privateKey }) => {
+        try {
+            const { Client } = await import("ssh2");
+            const fs = await import("fs");
+            let resolvedKey;
+            try {
+                resolvedKey = resolvePrivateKey(privateKey);
+            }
+            catch (err) {
+                return { content: [{ type: "text", text: `SCP key error: ${err.message}` }] };
+            }
+            return await new Promise((resolve) => {
+                const conn = new Client();
+                let finished = false;
+                const finish = (msg) => {
+                    if (!finished) {
+                        finished = true;
+                        try {
+                            conn.end();
+                        }
+                        catch { }
+                        resolve({ content: [{ type: "text", text: msg }] });
+                    }
+                };
+                // Connection timeout (20s)
+                const timeout = setTimeout(() => {
+                    finish(`SCP connection timed out after 20 seconds`);
+                }, 20000);
+                conn.on("ready", () => {
+                    clearTimeout(timeout);
+                    conn.sftp((err, sftp) => {
+                        if (err) {
+                            finish(`SFTP error: ${err.message}`);
+                            return;
+                        }
+                        if (direction === "upload") {
+                            let readStream, writeStream;
+                            try {
+                                readStream = fs.createReadStream(localPath);
+                                writeStream = sftp.createWriteStream(remotePath);
+                            }
+                            catch (streamErr) {
+                                finish(`Upload failed: ${streamErr.message}`);
+                                return;
+                            }
+                            writeStream.on("close", () => finish(`Upload complete: ${localPath} → ${user}@${target}:${remotePath}`));
+                            writeStream.on("error", (err) => finish(`Upload failed: ${err.message}`));
+                            readStream.on("error", (err) => finish(`Upload failed: ${err.message}`));
+                            readStream.pipe(writeStream);
+                        }
+                        else {
+                            let readStream, writeStream;
+                            try {
+                                readStream = sftp.createReadStream(remotePath);
+                                writeStream = fs.createWriteStream(localPath);
+                            }
+                            catch (streamErr) {
+                                finish(`Download failed: ${streamErr.message}`);
+                                return;
+                            }
+                            writeStream.on("close", () => finish(`Download complete: ${user}@${target}:${remotePath} → ${localPath}`));
+                            writeStream.on("error", (err) => finish(`Download failed: ${err.message}`));
+                            readStream.on("error", (err) => finish(`Download failed: ${err.message}`));
+                            readStream.pipe(writeStream);
+                        }
+                    });
+                }).on("error", (err) => {
+                    clearTimeout(timeout);
+                    finish(`SCP connection error: ${err.message}`);
+                });
+                try {
+                    conn.connect({
+                        host: target,
+                        username: user,
+                        ...(resolvedKey ? { privateKey: resolvedKey } : {})
+                    });
+                }
+                catch (err) {
+                    clearTimeout(timeout);
+                    finish(`SCP connect threw: ${err.message}`);
+                }
+            });
+        }
+        catch (fatalErr) {
+            return { content: [{ type: "text", text: `SCP fatal error: ${fatalErr.message || fatalErr}` }] };
+        }
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "it-tools-mcp",
-  "version": "3.0.15",
+  "version": "3.0.16",
   "description": "MCP server providing access to various IT tools and utilities for developers",
   "type": "module",
   "main": "./build/index.js",