node-exec-mcp 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,8 @@
+export interface Config {
+    nodeId: string;
+    openclawBin: string;
+    defaultCwd: string;
+    timeoutMs: number;
+}
+export declare function loadConfig(): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,UAAU,IAAI,MAAM,CA2BnC"}

package/dist/config.js

@@ -0,0 +1,20 @@
+import { existsSync } from "node:fs";
+export function loadConfig() {
+    const nodeId = process.env.NODE_ID;
+    if (!nodeId) {
+        throw new Error("NODE_ID environment variable is required. Set it to the target node's ID " +
+            "(from `openclaw nodes status`).");
+    }
+    const openclawBin = process.env.OPENCLAW_BIN || "openclaw";
+    const defaultCwd = process.env.DEFAULT_CWD || "/tmp";
+    const timeoutMs = parseInt(process.env.TIMEOUT_MS || "300000", 10);
+    if (isNaN(timeoutMs) || timeoutMs <= 0) {
+        throw new Error(`TIMEOUT_MS must be a positive integer, got: ${process.env.TIMEOUT_MS}`);
+    }
+    // Validate openclaw binary exists if an absolute path was given
+    if (openclawBin.startsWith("/") && !existsSync(openclawBin)) {
+        throw new Error(`OPENCLAW_BIN path does not exist: ${openclawBin}`);
+    }
+    return { nodeId, openclawBin, defaultCwd, timeoutMs };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AASrC,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,2EAA2E;YACzE,iCAAiC,CACpC,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,UAAU,CAAC;IAC3D,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC;IACrD,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEnE,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,+CAA+C,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,CACxE,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CACb,qCAAqC,WAAW,EAAE,CACnD,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AACxD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+async function main() {
+    const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js");
+    const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+    const { loadConfig } = await import("./config.js");
+    const { registerRunTool } = await import("./tools/run.js");
+    const require = createRequire(import.meta.url);
+    const { version } = require("../package.json");
+    const config = loadConfig();
+    const server = new McpServer({ name: "node-exec-mcp", version }, { capabilities: { logging: {} } });
+    registerRunTool(server, config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    const shutdown = async () => {
+        await server.close();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    transport.onclose = shutdown;
+}
+main().catch((err) => {
+    console.error("Fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAChC,yCAAyC,CAC1C,CAAC;IACF,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAC3C,2CAA2C,CAC5C,CAAC;IACF,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACnD,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAE3D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;IAEtE,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,EAClC,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAClC,CAAC;IAEF,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,MAAM,QAAQ,GAAG,KAAK,IAAmB,EAAE;QACzC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,SAAS,CAAC,OAAO,GAAG,QAAQ,CAAC;AAC/B,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/run.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Config } from "../config.js";
+export declare function registerRunTool(server: McpServer, config: Config): void;
+//# sourceMappingURL=run.d.ts.map

package/dist/tools/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/tools/run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAkB3C,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CA8HvE"}

package/dist/tools/run.js

@@ -0,0 +1,114 @@
+import { spawn } from "node:child_process";
+import { z } from "zod";
+export function registerRunTool(server, config) {
+    server.registerTool("run", {
+        title: "Run command on Mac",
+        description: "Execute a shell command on the remote Mac via OpenClaw node exec. " +
+            "Returns stdout, stderr, and exit code. Commands run as the Mac user " +
+            "with the configured approval policy.",
+        inputSchema: {
+            command: z
+                .string()
+                .describe("Shell command to execute on the Mac"),
+            cwd: z
+                .string()
+                .optional()
+                .describe(`Working directory on the Mac (default: ${config.defaultCwd})`),
+            timeout_ms: z
+                .number()
+                .positive()
+                .optional()
+                .describe(`Per-call timeout in milliseconds (default: ${config.timeoutMs})`),
+        },
+    }, async (args) => {
+        const cwd = args.cwd || config.defaultCwd;
+        const timeout = args.timeout_ms || config.timeoutMs;
+        const spawnArgs = [
+            "nodes",
+            "run",
+            "--node",
+            config.nodeId,
+            "--json",
+            "--timeout",
+            String(timeout),
+            "--cwd",
+            cwd,
+            "--",
+            "bash",
+            "-c",
+            args.command,
+        ];
+        return new Promise((resolve) => {
+            const child = spawn(config.openclawBin, spawnArgs, {
+                stdio: ["ignore", "pipe", "pipe"],
+                env: { ...process.env },
+            });
+            let stdout = "";
+            let stderr = "";
+            child.stdout.on("data", (chunk) => {
+                stdout += chunk.toString();
+            });
+            child.stderr.on("data", (chunk) => {
+                stderr += chunk.toString();
+            });
+            // Send progress notifications every 15s to prevent MCP adapter timeout
+            const progressInterval = setInterval(() => {
+                try {
+                    server.server.sendLoggingMessage({
+                        level: "info",
+                        data: "Command still running...",
+                    });
+                }
+                catch {
+                    // Transport closed — ignore
+                }
+            }, 15_000);
+            child.on("close", (exitCode) => {
+                clearInterval(progressInterval);
+                // Try to parse JSON response from stdout
+                try {
+                    const response = JSON.parse(stdout.trim());
+                    const p = response.payload;
+                    let output = "";
+                    if (p.stdout)
+                        output += p.stdout;
+                    if (p.stderr)
+                        output += (output ? "\n" : "") + `[stderr] ${p.stderr}`;
+                    if (p.error)
+                        output += (output ? "\n" : "") + `[error] ${p.error}`;
+                    if (p.timedOut)
+                        output += (output ? "\n" : "") + "[timed out]";
+                    output = output || "(no output)";
+                    output += `\n[exit code: ${p.exitCode}]`;
+                    resolve({
+                        content: [{ type: "text", text: output }],
+                        isError: !p.success,
+                    });
+                }
+                catch {
+                    // JSON parse failed — gateway-level error (plain text on stderr)
+                    const errorMsg = stderr.trim() ||
+                        stdout.trim() ||
+                        `Command failed with exit code ${exitCode}`;
+                    resolve({
+                        content: [{ type: "text", text: errorMsg }],
+                        isError: true,
+                    });
+                }
+            });
+            child.on("error", (err) => {
+                clearInterval(progressInterval);
+                resolve({
+                    content: [
+                        {
+                            type: "text",
+                            text: `Failed to spawn openclaw: ${err.message}`,
+                        },
+                    ],
+                    isError: true,
+                });
+            });
+        });
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/tools/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/tools/run.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "node-exec-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for executing commands on remote machines via OpenClaw node exec",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "node-exec-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "author": "Andreas Spannagel",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pandysp/node-exec-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/pandysp/node-exec-mcp/issues"
+  },
+  "homepage": "https://github.com/pandysp/node-exec-mcp#readme",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "node-exec",
+    "remote-execution",
+    "openclaw"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "@types/node": "^22.0.0",
+    "vitest": "^3.2.0"
+  }
+}