MCP Cli Exec

🚀 MCP-CLI-EXEC Server

A powerful MCP server for CLI command execution that supports running shell commands with structured output. This package focuses on command execution capabilities, distinguishing it from other MCP CLI tools.

🚀 Quick Start

The MCP-CLI-EXEC Server is a robust solution for executing CLI commands with structured output. It offers a range of features to handle various command execution scenarios efficiently.

✨ Features

Tools

cli-exec-raw

Execute a raw CLI command and return structured output.

• Accept a command string and an optional timeout (default: 5 minutes).
• Return detailed execution results, including stdout, stderr, and exit code.
• Handle errors flexibly and provide structured error responses.

cli-exec

Execute one or more CLI commands in a specified working directory.

• Support a single command, a chain of commands connected by &&, or an array of commands.
• All commands are executed in the specified working directory.
• Return detailed results for each command:
  • Success/failure status
  • Exit code
  • stdout and stderr (without ANSI codes)
  • Execution duration
  • Working directory
• Stop at the first command failure.
• Optional timeout for each command (default: 5 minutes).

Note: Due to execution context limitations, each command runs independently. Directory changes (cd) in a command do not affect subsequent commands. All commands are executed in the initially specified working directory.

Output Format

Commands return structured results, including:

• Success/failure status
• Exit code
• stdout and stderr (without ANSI codes)
• Execution duration
• Working directory
• Detailed error information if there is an error.

💻 Usage Examples

Basic Usage

cli-exec-raw

Simple command execution:

{
  "command": "echo Hello World"
}

With timeout setting:

{
  "command": "long-running-script.sh",
  "timeout": 300000
}

cli-exec

Execute a single command in a specific directory:

{
  "workingDirectory": "/path/to/project",
  "commands": "npm install"
}

Execute multiple commands in the same working directory:

{
  "workingDirectory": "C:\\project",
  "commands": [
    "dir /b",
    "npm run build"
  ]
}

📦 Installation

Optionally install from npm:

npm install -g mcp-cli-exec
# Or use pnpm
pnpm add -g mcp-cli-exec

Or use npx directly in the configuration.

For Cline VSCode Extension

Add to %APPDATA%/Code - Insiders/User/globalStorage/rooveterinaryinc.roo-cline/exec:

{
  "command": "echo Hello World"
}

For Claude Desktop

Add to Claude Desktop settings:

{
  "workingDirectory": "C:\\project",
  "commands": [
    "dir /b",
    "npm run build"
  ]
}

🔧 Technical Details

• Default timeout: 5 minutes
• Use execa to execute external commands
• Each command runs independently without affecting others.

📚 Documentation

Development

The project is built using TypeScript and the MCP SDK. To run tests, execute:

npm test

Debugging

To debug in VSCode, configure launch.json as follows:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Debug Server",
      "type": "node",
      "request": "launch",
      "program": "dist/index.js",
      "args": []
    }
  ]
}