MCP Shell Server

Name: MCP Shell Server
Author: MCP-Mirror

@MCP-Mirror

Repository

About MCP Shell Server

Mirror of

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

Basic information

Config

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

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

Tools

No tools detected

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

FAQ from MCP Shell Server

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).