MCP.so
Sign In

MCP Shell Server

@MCP-Mirror

Repository

About MCP Shell Server

Mirror of

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

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

Does MCP Shell Server support Windows shells?

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

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

Basic information

Category

Developer Tools

License

MIT license

Transports

stdio

Author

MCP-Mirror

More Developer Tools MCP servers

Termany

thinkany-ai

Agent-Native Terminal

174

Skycloak

Manage your Skycloak-hosted Keycloak: clusters, realms, apps, SSO and users, from any MCP client.

Windframe

Windframe MCP gives your AI the design taste needed to create consistent, production-ready UI that feels intentionally designed. Available at https://windframe.dev/mcp

S

SecondSim

econdSim provisions real UK mobile numbers (non-VoIP) via eSIM, built for freelancers, sole traders, small businesses, and enterprise teams. Unlike VoIP apps and virtual numbers, SecondSim numbers register as genuine phy

CodeSentinel

icohangar-ops

Codebase health as MCP tools: dead code, circular dependencies, coupling, architectural drift.