Run Shell Command

Provides a minimal shell-command MCP server to run local commands and inspect services from an MCP client.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "benyue1978-run-command-mcp": {
      "command": "npx",
      "args": [
        "github:benyue1978/run-command-mcp",
        "start"
      ]
    }
  }
}

You can run shell commands against your local environment through an MCP server that exposes a simple, command-driven interface. This makes it easy to query services, start or stop processes, and automate ad hoc tasks directly from your MCP client without switching between terminals.

How to use

Set up this MCP server in your MCP client by adding a new MCP with the following details. You will start the server with a single command and then send shell commands through the client to perform tasks such as locating services on a specific port or inspecting running processes.

How to install

Prerequisites you need before installation: Node.js (and npm) installed on your machine.

Install and run the MCP server using the following exact command sequence.

# Start the MCP server via npx
npx github:benyue1978/run-command-mcp start

Additional content

MCP connection details are provided below so you can copy them into your MCP client configuration. No extra setup is required beyond what is shown here. If you want to execute multiple shell tasks, you can run each command from your MCP client by passing the appropriate arguments to the MCP starter.