it-tools-mcp 3.0.15 → 3.0.17

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 **88 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 88 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 88 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

@@ -6,7 +6,7 @@
 
 > **📝 Note**: A condensed version of this README is automatically synced to [Docker Hub](https://hub.docker.com/r/wrenchpilot/it-tools-mcp) due to character limits.
 
-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.
 
 ## 📦 Installation & Setup
 
@@ -80,13 +80,13 @@ echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"base64-enc
 
 ## 🛠️ Tool Categories
 
-This MCP server provides **86 tools** across **8 categories**:
+This MCP server provides **87 tools** across **8 categories**:
 
 - **🔧 Encoding & Decoding** (9 tools): Base64, URL, HTML entities, text-to-binary, Unicode
 - **📝 Data Format** (11 tools): JSON, XML, YAML, SQL, TOML, Markdown ↔ HTML conversion
 - **🔐 Security & Crypto** (12 tools): Hashing (MD5, SHA1-512), HMAC, JWT, bcrypt, passwords, tokens
 - **✨ Text Processing** (16 tools): Case conversion, stats, diff, ASCII art, NATO alphabet, slugify
-- **🌐 Network & System** (19 tools): IPv4/IPv6 subnets, URL parsing, MAC addresses, phone formatting, ps, top, cat, head, tail, grep, ping, nslookup, telnet, dig, ssh, random-port, mac-address-generate, ip/ipv6 calculators
+- **🌐 Network & System** (20 tools): IPv4/IPv6 subnets, URL parsing, MAC addresses, phone formatting, ps, top, cat, head, tail, grep, ping, nslookup, telnet, dig, ssh, random-port, mac-address-generate, ip/ipv6 calculators, curl
 - **🔢 Math & Calculations** (6 tools): Expression evaluation, base conversion, temperature, percentages
 - **🆔 ID & Code Generators** (4 tools: UUID, ULID, QR codes, SVG placeholders
 - **🛠️ Utility Tools** (9 tools): Color, MIME, HTTP, device info, email normalization, etc.
@@ -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,147 @@ 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}` }] };
+        }
+    });
+    // curl Tool (HTTP client)
+    server.tool("curl", "Make HTTP requests (GET, POST, etc.) like curl", {
+        url: z.string().describe("URL to request"),
+        method: z.enum(["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD"]).default("GET").describe("HTTP method"),
+        headers: z.record(z.string()).optional().describe("Request headers (object of key-value pairs)"),
+        body: z.string().optional().describe("Request body (for POST/PUT/PATCH)")
+    }, async ({ url, method, headers, body }) => {
+        try {
+            // Use native fetch if available (Node 18+), fallback to node-fetch
+            let fetchImpl;
+            if (typeof globalThis.fetch === 'function') {
+                fetchImpl = globalThis.fetch;
+            }
+            else {
+                fetchImpl = (await import('node-fetch')).default;
+            }
+            const options = {
+                method,
+                headers: headers || {},
+            };
+            if (body && ["POST", "PUT", "PATCH"].includes(method)) {
+                options.body = body;
+            }
+            const response = await fetchImpl(url, options);
+            let contentType = '';
+            if (response.headers && typeof response.headers.get === 'function') {
+                contentType = response.headers.get('content-type') || '';
+            }
+            let responseBody;
+            if (contentType.includes('application/json')) {
+                responseBody = await response.json();
+                responseBody = JSON.stringify(responseBody, null, 2);
+            }
+            else {
+                responseBody = await response.text();
+            }
+            return {
+                content: [
+                    { type: "text", text: `Status: ${response.status} ${response.statusText}` },
+                    { type: "text", text: `Headers:\n${JSON.stringify(Object.fromEntries(response.headers.entries()), null, 2)}` },
+                    { type: "text", text: `Body:\n${responseBody}` }
+                ]
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `curl failed: ${error instanceof Error ? error.message : error}` }] };
+        }
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "it-tools-mcp",
-  "version": "3.0.15",
+  "version": "3.0.17",
   "description": "MCP server providing access to various IT tools and utilities for developers",
   "type": "module",
   "main": "./build/index.js",
@@ -84,6 +84,7 @@
     "marked": "^15.0.12",
     "mathjs": "^14.5.2",
     "mime-types": "^3.0.1",
+    "node-fetch": "^3.3.2",
     "papaparse": "^5.5.3",
     "ping": "^0.4.4",
     "ps-list": "^8.1.1",