Can I see detailed logs and error handling with Shell Server?

Yes, Shell Server provides detailed error handling and logging to help you track and diagnose issues during command execution. Logs are written to `mcp-shell.log`.

What shells does Shell Server support?

Shell Server supports a variety of shells, including bash, zsh, fish, PowerShell, and cmd.

SSyncDev

Start a project

Shell Server MCP Server

Executes shell commands via the Model Context Protocol (MCP) enabling safe execution of shell commands by AI agents.

Local serverstdio★ 8

What is the Shell Server MCP Server?

Executes shell commands via the Model Context Protocol (MCP) enabling safe execution of shell commands by AI agents.

The short version

A server that uses the Model Context Protocol (MCP) to execute shell commands. It functions as a bridge that allows AI agents to safely execute shell commands.

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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
shell_exec
hostname
platform
shell
username

How to install the Shell Server MCP Server

{
  "mcpServers": {
    "shell": {
      "command": "npx",
      "args": ["-y", "@mkusaka/mcp-shell-server"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

“Use Shell Server to shell exec.”
“Use Shell Server to hostname.”
“Use Shell Server to platform.”

Frequently asked questions

Shell Server is a tool that uses the Model Context Protocol (MCP) to execute shell commands, allowing AI agents to safely interact with the system by running commands in a controlled environment.

Alternatives to the Shell Server MCP Server

Filesystem

Official

Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.

File Systems & StorageTypeScript★ 63.0k

Context7

Official

Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.

Documentation & API ReferencesRemoteTypeScript★ 32.0k

Lockspec

MCP server giving AI coding agents version-pinned API context from your OpenAPI specs.

Developer Tools

Cadquery

A Model Context Protocol (MCP) server that provides CAD generation and verification tools for Claude Code. This server enables conversational 3D

Developer ToolsPython

Bambu Printer MCP

A Bambu Lab-focused MCP server for controlling Bambu printers, manipulating STL files, and managing end-to-end 3MF print workflows from Claude Desktop, Claude Code, or any MCP-compatible client.