Remote Command

🚀 Remote Command MCP Server

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

🚀 Quick Start

To start using the Remote Command MCP Server, follow these steps:

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 file:

   npm run build
   

5. Start the server:

   node build/index.js
   

✨ Features

• Cross - platform command execution: Execute commands across different operating systems.
• Automatic command standardization: Automatically standardize commands between Windows and Unix systems.
• Built - in error handling: Provide detailed error messages.
• Comprehensive response: Include both stdout and stderr in the response.
• Directory - specific command execution: Restrict command execution to a specific directory.
• Appropriate shell selection: Choose the appropriate shell based on the platform.

📦 Installation

1. Download the project code.
2. Navigate to the project root directory.
3. Install dependencies:

   npm install
   

4. Build the project:

   npm run build
   

💻 Usage Examples

Basic Usage

The main tool 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 a command similar to 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

• Limit command execution directory: Use the cwd parameter to restrict command execution to a specific directory.
• Avoid elevated - privilege commands: Do not execute commands with elevated privileges.
• Control access rights: Manage access permissions to the MCP server.
• Monitor sensitive operations: Keep an eye on 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 file 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.