MCP Shell Server

by tumf• 201•• Scanned•Claim this listing•Request removal
Security & Testingaudit logcommand whitelistmcpmodel context protocolsecurity

Secure MCP server for whitelisted shell command execution with stdin, argv pipelines, timeouts, and structured audit logging.

MCP Shell Server is an open-source mcp server by tumf, written mainly in Python, with 201 GitHub stars and the MIT license. Its code was last updated Oct 29, 2026. The latest PyPI release is mcp-shell-server 1.1.14, published Oct 19, 2026, with 574 downloads last week.

Scan summary: scanned Nov 5, 2026 at commit c1c8059. Seen able to run shell commands. Scan policy

How to install MCP Shell Server

Built from the start command in the project's README: uvx mcp-shell-server. Check the README for required keys or settings.

Claude Code · Terminal
claude mcp add mcp-shell-server -- uvx mcp-shell-server
Claude Desktop · claude_desktop_config.json
{
  "mcpServers": {
    "mcp-shell-server": {
      "command": "uvx",
      "args": [
        "mcp-shell-server"
      ]
    }
  }
}
Cursor · .cursor/mcp.json
{
  "mcpServers": {
    "mcp-shell-server": {
      "command": "uvx",
      "args": [
        "mcp-shell-server"
      ]
    }
  }
}
VS Code · Terminal
code --add-mcp '{"name":"mcp-shell-server","command":"uvx","args":["mcp-shell-server"]}'

What MCP Shell Server can touch

  • Run shell commandsListed as a tool: shell_execute
  • Run dynamic codeNot seen in this scan
  • Read or write filesNot seen in this scan
  • Read environment and secretsNot seen in this scan
  • Control a web browserNot seen in this scan
  • Connect to databasesNot seen in this scan
  • Read or send messagesNot seen in this scan
  • Touch money or tradingNot seen in this scan
  • Connect to the internetNo connections seen while running

"Not seen" means our checks did not find it, and the tool may still do it. Covers commit c1c8059, Nov 5, 2026. See the scan policy.

Before you install MCP Shell Server

AgenticMart scanned MCP Shell Server on Nov 5, 2026 with automated checks for hidden code, known-malicious packages, leaked secrets and vulnerable dependencies. The result covers one commit under our scan policy, so review what access you give it and check any advisories shown here.

What it can access

  • An MCP server is a program your AI app starts and talks to. A local one runs with your user's permissions: it can see the files, environment variables and network your account can.
  • Based on its description and topics, it likely needs to run shell commands.

Before you install

  1. Keep tool-call approval on, and run it in a container if you can.
  2. Pin the version you reviewed instead of always installing the latest release.
  3. Read the tool list or scripts before the first run, and keep approval prompts on for actions that write, send or delete.
  • Maintained by tumf on GitHub, 201 stars and 50 forks. Popularity is not proof of safety.
  • Last code change: Oct 29, 2026.
  • Open-source license: MIT.

Tools MCP Shell Server exposes (1)

Listed by the server itself during our scan of commit c1c8059.

  • shell_execute

    Execute an allowed command as an argv array on the MCP server host. Allowed commands run with the server process's OS authority; the allowlist controls executable names, not what an allowed program does. Allowed commands: Allowed patterns: Default timeout: 30s; maximum timeout: 300s; output cap: 1

MCP Shell Server is an open-source mcp server by tumf, written mainly in Python. Secure MCP server for whitelisted shell command execution with stdin, argv pipelines, timeouts, and structured audit logging.

At a glance

Stars
201
Forks
50
Language
Python
License
MIT
Created
Dec 2024
Last update
Oct 29, 2026
Type
MCP Server
Price
Free

Topics

audit-logcommand-whitelistmcpmodel-context-protocolsecurityshell

Questions about MCP Shell Server

What is MCP Shell Server?

Secure MCP server for whitelisted shell command execution with stdin, argv pipelines, timeouts, and structured audit logging.

Who maintains MCP Shell Server?

MCP Shell Server is maintained by tumf on GitHub (tumf/mcp-shell-server). AgenticMart lists it from public repository data.

Is MCP Shell Server safe to use?

AgenticMart scanned MCP Shell Server on Nov 5, 2026 with automated checks for hidden code, known-malicious packages, leaked secrets and vulnerable dependencies. The result covers one commit under our scan policy, so review what access you give it and check any advisories shown here.

What license does MCP Shell Server use?

It is published under the MIT license.

MCP Shell Server alternatives

View more →

Similar mcp servers in Security & Testing, ranked by GitHub stars. Compare licence, recent activity and scan status before you choose.

NameStarsLicenceLast updatedScan
MCP Shell Server (this page)
tumf
201MITOct 29, 2026Scanned, no flagged issues
Hexstrike AI
0x4m4
13kMITAug 3, 2026Scanned, no flagged issues
Viper
FunnyWolf
5.3kNone foundMay 31, 2026Not scanned yet
Open Ontologies
fabio-rovai
2.7kMITOct 30, 2026Scanned, no flagged issues
Qu1cksc0pe
CYB3RMX
2.1kGPL-3.0Sep 18, 2026Scanned, no flagged issues
Cve MCP Server
mukul975
1.7kApache-2.0Oct 1, 2026Scanned, no flagged issues