MCP Shell Server

@MCP-Mirror

Repository

Basic information

About MCP Shell Server

Mirror of

#mcp-shell-server #shell-execution #ai-agents

MCP Shell Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mkusaka_mcp-shell-server": {
      "command": "node",
      "args": [
        "dist/index.js"
      ]
    }
  }
}

MCP Shell Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Shell Server?

MCP Shell Server is a bridge that uses the Model Context Protocol (MCP) to allow AI agents to safely execute shell commands. It supports single-line and multi-line commands across multiple shells and is designed for integration with AI assistants like Cursor.

How to use MCP Shell Server?

Install globally via npm, yarn, or pnpm, then add the server to your MCP configuration (e.g., in Cursor's ~/.cursor/config.json). The server provides a shell_exec tool that accepts a required command string. You can also specify a custom shell using the -s or --shell command-line argument.

Key features of MCP Shell Server

Execute shell commands (single-line and multi-line support)
Support for various shells (bash, zsh, fish, powershell, cmd, etc.)
Detailed error handling and logging
MCP Inspector compatible
Provides system information as resources (hostname, platform, shell, username, system-info)

Use cases of MCP Shell Server

AI assistants executing shell commands to solve coding tasks
Retrieving system information (hostname, platform, memory, uptime) during agent interactions
Running multi-line scripts (e.g., heredoc) via AI tools
Debugging and system administration through natural language interfaces

Frequently asked questions

What shells does MCP Shell Server support?

It supports bash, zsh, fish, powershell, cmd, and others. You can specify a custom shell path with the `-s` or `--shell` argument when starting the server.

What is the required parameter for the `shell_exec` tool?

The `command` parameter is required and must be a string containing the shell command to execute.

How do I install MCP Shell Server?

Install it globally: `npm install -g @mkusaka/mcp-shell-server`, `yarn global add @mkusaka/mcp-shell-server`, or `pnpm add -g @mkusaka/mcp-shell-server`.

What system resources does MCP Shell Server expose?

It exposes `hostname://`, `platform://`, `shell://`, `username://`, and `system-info://` (which returns hostname, platform, shell, username, CPU count, total/free memory, and uptime).

Does MCP Shell Server support Windows shells?

Yes, it supports both powershell and cmd in addition to Unix shells like bash and zsh.

Comments

More Developer Tools MCP servers

Capgo MCP

Cap-go

Console, Backend and CLI to manage Capgo Instant update and Native build for Capacitor apps Build and upload to app store your mobile app

Routebase

Routebase keeps your API's design, docs, contract tests, mocks and monitoring in one living OpenAPI spec so they can't drift apart. Agents work on that same source of truth, under your team's permissions.

OrangePro

Aamir Siddiqui

OrangePro local-first CLI + MCP server for behavior mapping, grounded test generation, and dynamic proof.

Ramen

bkraad47

Multi-zone MCP server for GKE/EKS/AKS: Python tools from git, NeMo guardrails, SSO, autoscaling.

Cronwatch

cronwatchdev

CronWatch records every run of your scheduled jobs in your own database, and speaks up when one is missed, fails, gets stuck, runs slow or costs too much. CronWatch is free and open-source.