Linux Command MCP

🚀 Linux Command MCP (Model Context Protocol)

Linux Command MCP is a remote command execution system built on the Model Context Protocol (MCP), supporting secure and standardized execution of Linux commands.

🚀 Quick Start

Prerequisites

• Node.js (v18.x or higher)
• npm
• PM2 (for process management)

Installation

1. Clone the repository:

git clone <repository-url>
cd linux-command-mcp

2. Install server dependencies:

cd server
npm install
npm run build

3. Install client dependencies:

cd ../client
npm install
npm run build

Usage

Start the Server

1. Navigate to the server directory:

cd server

2. Start the MCP proxy using the following command:

node dist/index.js

Client Usage

Refer to the relevant documentation for using this MCP server in Claude Desktop.

✨ Features

Linux Command MCP is a remote command execution system based on the Model Context Protocol (MCP), enabling secure and standardized execution of Linux commands.

📦 Installation

MCP Server Configuration for Claude Desktop

Understanding the Configuration

The MCP server is configured in the claude_desktop_config.json file, typically located at ~/.config/Claude/claude_desktop_config.json.

Configuration Structure

"mcpServers": {
  "server-name": {
    "command": "node|npx|uvx",
    "args": ["server-specific parameters"],
    "env": {
      "OPTIONAL_ENVIRONMENT_VARIABLES": "value"
    }
  }
}

Linux Command MCP Server Configuration

"linux-command": {
  "command": "node",
  "args": [
    "/full/path/to/linux-command-mcp/server/dist/index.js"
  ]
}

Configuration Explanation

• "command": Specifies the executor (node, npx, uvx).
• "args": The full path to the server executable file.
• Ensure the path is an absolute path to index.js.

Important Configuration Tips

• Always use full absolute paths.
• Verify file permissions.
• Ensure the specified file is executable.

💻 Usage Examples

Basic Usage

The MCP proxy will start at localhost:3000 and support the following operations:

1. Check the current directory:

curl http://localhost:3000/mcp/currentdir

2. Execute a command and get the result:

curl -X POST "http://localhost:3000/mcp/command" -H "Content-Type: application/json" -d '{"command":"ls"}'

📚 Documentation

Contact Information

• Email: xkiranj.1980@gmail.com
• Blockchain Addresses:
  • Ethereum: 0x67F367edb83d8fdF48E7E7Cfcb35183e746c292c
  • Bitcoin: bc1q688np092y8raxag5e6573chrcgck5756yv476v