Remote Command

This MCP server enables you to execute shell commands remotely in a cross‑platform way. It provides a unified interface to run commands on the host machine, automatically handling differences between Windows and Unix-like systems and streaming outputs back to you.

How to use

Use the Remote Command MCP Server with an MCP client to run any valid shell command on the host system. You can perform system inquiries, manage packages, run development tools, operate files and networks, control services, and execute virtually any CLI command your environment supports. You specify the command and, optionally, the working directory for execution. The server handles platform specifics so your commands work consistently across Windows and Unix-like systems.

How to install

Prerequisites: Node.js is required to run the MCP server. Ensure you have Node.js installed on your machine.

# Step 1: Clone the project
git clone https://github.com/deepsuthar496/Remote-Command-MCP
cd remote-command-server

# Step 2: Install dependencies
npm install

# Step 3: Build the server
npm run build

Configure the MCP server in your client settings to point to the local runtime of the built server.

{
  "mcpServers": {
    "remote_command": {
      "name": "remote_command",
      "type": "stdio",
      "command": "node",
      "args": ["path/to/remote-command-server/build/index.js"],
      "disabled": false,
      "env": []
    }
  }
}

Additional configuration and notes

The server is designed to work with a single tool named execute_remote_command. This tool accepts a shell command to execute and an optional working directory (cwd). You can perform a wide range of tasks, including system information queries, package management, file operations, network checks, development tasks, and service management.

For cross‑platform command handling, the server translates common Unix commands to their Windows equivalents where possible (for example, ls becomes dir on Windows) and selects the appropriate shell depending on the host platform (cmd.exe on Windows and /bin/sh on Unix-like systems). The server returns both standard output and error details when a command fails.

Available tools

execute_remote_command

A single MCP tool that executes any valid shell command on the host OS, with an optional working directory. It supports a wide range of commands across different environments and returns stdout and stderr with the result.