MCP.so
Sign In

Shell MCP Server

@odysseus0

Repository

About Shell MCP Server

No overview available yet

Basic information

Category

Developer Tools

Runtime

python

Transports

stdio

Publisher

odysseus0

Config

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

{
  "mcpServers": {
    "mcp-server-shell": {
      "command": "python",
      "args": [
        "-m",
        "mcp_server_shell"
      ]
    }
  }
}

Tools

1

Execute a shell command and return its output

Overview

What is Shell MCP Server?

A Model Context Protocol server that provides shell command execution capabilities. It enables LLMs to execute shell commands and receive their output in a controlled manner.

How to use Shell MCP Server?

Install via uvx mcp-server-shell or pip install mcp-server-shell, then configure the server in your MCP client (e.g., Claude.app or Zed) by adding the appropriate JSON entry. Use the execute_command tool with a command string argument to run any shell command.

Key features of Shell MCP Server

  • Executes shell commands and returns combined stdout/stderr output.
  • Returns the command’s exit code for success/failure detection.
  • Supports installation via uv (uvx) or pip.
  • Ready‑made configurations for Claude.app and Zed.
  • Can be debugged using the MCP inspector.
  • Licensed under the MIT License.

Use cases of Shell MCP Server

  • “List files in the current directory.”
  • “Show the contents of a specific file (e.g., README.md).”
  • “Check the current system date.”
  • “Verify if Python is installed and its version.”

FAQ from Shell MCP Server

What does the Shell MCP Server do?

It gives LLMs the ability to run arbitrary shell commands and receive their output (stdout, stderr) and exit code in real time.

How do I install the Shell MCP Server?

You can run it directly with uvx mcp-server-shell (no install needed) or install it via pip install mcp-server-shell and then execute python -m mcp_server_shell.

How do I configure the server for Claude.app?

Add a JSON entry to your Claude settings under mcpServers – either using uvx or python as the command, with the appropriate arguments.

Are there security risks?

Yes. The server executes shell commands directly on your system. Use with caution and implement appropriate security measures to prevent unauthorized or dangerous command execution.

How can I debug the server?

Use the MCP inspector tool: run npx @modelcontextprotocol/inspector uvx mcp-server-shell (or a similar command for pip installations).

Comments

More Developer Tools MCP servers

Code Index MCP

johnhuang316

A Model Context Protocol (MCP) server that helps large language models index, search, and analyze code repositories with minimal setup

979

OpenSumi

opensumi

A framework helps you quickly build AI Native IDE products. MCP Client, supports Model Context Protocol (MCP) tools via MCP server.

3.6K

test

cloudwego

The ultimate LLM/AI application development framework in Go.

12.2K

MCP-Scan: An MCP Security Scanner

invariantlabs-ai

Security scanner for AI agents, MCP servers and agent skills.

2.8K

Unity MCP (Server + Plugin)

IvanMurzak

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for fr

3.5K