Remote Command

🚀 Remote Command MCP Server

A Model Context Protocol (MCP) server that supports remote command execution across different operating systems. This server provides a unified interface to execute shell commands and automatically handles platform differences between Windows and Unix-like systems.

🚀 Quick Start

The Remote Command MCP Server is a powerful tool for executing commands remotely across different operating systems. It simplifies the process of running shell commands by handling platform-specific differences automatically.

✨ Features

• Cross-platform command execution: Execute commands seamlessly across different operating systems.
• Automatic command standardization: Automatically standardize commands between Windows and Unix systems.
• Built-in error handling: Provide detailed error messages for easy debugging.
• Comprehensive response: Include both stdout and stderr in the response.
• Directory-specific command execution: Limit command execution to specific directories.
• Platform-appropriate shell selection: Automatically select the appropriate shell based on the platform.

📦 Installation

1. Download the project code.
2. Change the working directory to the project root.
3. Run the installation command:

npm install

4. Build the executable:

npm run build

💻 Usage Examples

Basic Usage

To start the server, run the following command:

node build/index.js

Main Tool

The main tool for executing remote commands is execute_remote_command.

Parameters

• command: The command to be executed (required).
• cwd: The working directory for command execution (optional, default is the current directory).

Examples

1. Execute ls on Unix systems, equivalent to dir on Windows:

execute_remote_command({
  command: "list",
  cwd: "."
});

2. Search for .disk files:

execute_remote_command({
  command: "find . -name '*.disk'",
  cwd: "/home/user"
});

📚 Documentation

Security Precautions

1. Limit command execution directories using cwd.
2. Avoid executing commands with elevated privileges.
3. Control access to the MCP server.
4. Monitor sensitive operations.

Platform Command Handling

Command Conversion

• ls ↔ dir
• cp ↔ copy
• rm ↔ del

Shell Selection

• Windows: cmd.exe
• Unix/Linux: /bin/sh

Error Handling

The server provides detailed error messages in the response. If a command fails, you will receive an error message with detailed information about what went wrong.

Example error response:

{
  "content": [
    {
      "type": "text",
      "text": "Command execution error: The command failed with exit code 1"
    }
  ],
  "isError": true
}

Development

Project Structure

remote-command-server/
├── src/
│   └── index.ts    # Main server implementation
├── package.json
├── tsconfig.json
└── README.md

Build

npm run build

This command compiles the TypeScript code and creates an executable in the build directory.

Contribution Guidelines

1. Fork the project repository.
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add some amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Open a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.