it-tools-mcp 3.0.14 → 3.0.16

package/README.dockerhub.md

@@ -4,13 +4,13 @@
 [![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
 
 Add to your VS Code `settings.json`:
 
-*Node*
+### Node
 
 ```json
 {
@@ -29,7 +29,7 @@ Add to your VS Code `settings.json`:
 }
 ```
 
-*Docker*
+#### Docker
 
 ```json
 {
@@ -56,17 +56,19 @@ 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
 
 ### Password Hash Generation
+
 ![Password Hash Example](https://raw.githubusercontent.com/wrenchpilot/it-tools-mcp/master/screenshots/password-hash-example.png)
 
 ### ASCII Art Text Generation  
+
 ![ASCII Art Text Example](https://raw.githubusercontent.com/wrenchpilot/it-tools-mcp/master/screenshots/ascii-art-text-example.png)
 
-*Examples of using the IT Tools MCP server with VS Code Copilot Chat*
+#### Examples of using the IT Tools MCP server with VS Code Copilot Chat
 
 ## 🏗️ Architecture
 
@@ -76,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

@@ -14,7 +14,7 @@ A comprehensive Model Context Protocol (MCP) server that provides access to 86 I
 
 Add to your VS Code `settings.json`:
 
-*Node*
+#### Node
 
 ```json
 {
@@ -33,7 +33,7 @@ Add to your VS Code `settings.json`:
 }
 ```
 
-*Docker*
+#### Docker
 
 ```json
 {
@@ -101,7 +101,7 @@ This MCP server provides **86 tools** across **8 categories**:
 
 ![ASCII Art Text Example](screenshots/ascii-art-text-example.png)
 
-*Examples of using the IT Tools MCP server with VS Code Copilot Chat for secure password hashing and creative ASCII art generation*
+Examples of using the IT Tools MCP server with VS Code Copilot Chat for secure password hashing and creative ASCII art generation.
 
 ## Available Tools
 
@@ -171,12 +171,13 @@ This MCP server provides **86 tools** across **8 categories**:
 | `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`                                                                                                                                                                                       |
 | `url-parse`                 | Parse URL components                   | `url: string`                                                                                                                                                                                             |
 | `random-port`               | Generate random ports                  | `count?: number`, `min?: number`, `max?: number`, `exclude?: number[]`                                                                                                                                    |
-| `mac-address-generate`      | Generate MAC address                   | `prefix?: string`, `separator?: ':' | '-'`                                                                                                                                                                |
+| `mac-address-generate`      | Generate MAC address                   | `prefix?: string`, `separator?: ':' \| '-'`                                                                                                                                                               |
 | `phone-format`              | Parse and format phone numbers         | `phoneNumber: string`, `countryCode?: string`                                                                                                                                                             |
 | `iban-validate`             | Validate IBAN                          | `iban: string`                                                                                                                                                                                            |
 | **Math & Calculations**     |                                        |                                                                                                                                                                                                           |

package/build/tools/idGenerators.js

@@ -78,18 +78,18 @@ For production use, please use a proper ULID library.`,
             console.log(`[DEBUG] QR code generated successfully`);
             // Extract just the base64 data (remove the data:image/png;base64, prefix)
             const base64Data = dataUrl.split(',')[1];
+            const markdown = `![QR Code](data:image/png;base64,${base64Data})`;
             return {
                 content: [
                     {
                         type: "text",
                         text: `📱 QR Code for: "${text}"
-
-📊 Data encoded: "${text}" (${text.length} characters)
+\n📊 Data encoded: "${text}" (${text.length} characters)
 🎯 Error correction: Medium (M)
 📐 Image size: ${Math.max(256, size * 128)}x${Math.max(256, size * 128)} pixels
-
-✅ This QR code can be scanned with any QR code reader app
-💡 Generated using the 'qrcode' npm library!`,
+\n✅ This QR code can be scanned with any QR code reader app
+💡 Generated using the 'qrcode' npm library!
+\n---\n**Markdown for inline display:**\n${markdown}`,
                     },
                     {
                         type: "image",
@@ -110,6 +110,15 @@ For production use, please use a proper ULID library.`,
                 ],
             };
         }
+        // Fallback return in case of unexpected behavior
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Unknown error: No response generated by qr-generate.",
+                },
+            ],
+        };
     });
     // SVG placeholder generator
     server.tool("svg-placeholder-generator", "Generate SVG placeholder images", {

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.14",
+  "version": "3.0.16",
   "description": "MCP server providing access to various IT tools and utilities for developers",
   "type": "module",
   "main": "./build/index.js",