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

AptiBuild AI — Career Intelligence

ParklandBuilds

AptiBuild AI — Career Intelligence MCP Server Structured career decision scaffolding for AI agents. Provides personality-conditioned business idea generation, official BLS OEWS wage data, FRED labor market signals, and

Termany

thinkany-ai

Agent-Native Terminal

174

Perfex CRM

themesic

Turn Perfex CRM into an AI-ready workspace. This MCP server exposes your full REST API to Claude, ChatGPT and any AI agent, so leads, invoices and tasks are one prompt away.

Mcp-Warden

ermoluk

Local-first credential broker for MCP. AI coding agents (Claude Code, Cursor, Codex…) call APIs, SSH and databases through scoped presets; secrets stay in your OS keychain and never enter the agent's context.

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott