drio
Open app

🖥️ Shell MCP Server

Source

Mirror of

Catalog onlyCatalog onlySTDIO

Overview

Shell MCP Server is a tool that adds secure shell command execution capabilities to AI applications, specifically designed for the Model Context Protocol.

To use Shell MCP Server, install it via pip and configure it in your AI application to enable shell command execution.

  • 🔒 Secure Execution: Commands run only in specified directories. - 🐚 Multiple Shells: Supports bash, sh, cmd, and powershell. - ⏱️ Timeout Control: Automatically terminates long-running commands. - 🌍 Cross-Platform: Works on both Unix and Windows systems. - 🛡️ Safe by Default: Built-in directory and shell validation.
  1. Executing system commands securely in AI applications.
  2. Managing files and directories through shell commands.
  3. Performing project management tasks like Git operations.
  4. Monitoring system resources and processes.

Add to your AI client

Use these steps to connect 🖥️ Shell MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

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

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

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

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

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

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "blazickjp-shell-mcp-server-mcp-mirror": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-blazickjp-shell-mcp-server-mcp-mirror"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

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

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

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

FAQ

Can I use Shell MCP Server on Windows?

Yes! Shell MCP Server is designed to work on both Unix and Windows systems.

How do I install Shell MCP Server?

You can install it using pip with the command: `pip install shell-mcp-server`.

What security features does Shell MCP Server provide?

It includes directory isolation, shell control, timeout protection, and path validation to prevent traversal attacks.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":684,"uuid":"b3590511-6c59-4032-9f34-98343c7b8e8f","name":"blazickjp_shell-mcp-server","title":"🖥️ Shell MCP Server","description":"Mirror of","avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","created_at":"2024-12-30T03:26:14.740Z","updated_at":"2025-02-23T07:16:03.964Z","status":"created","author_name":"MCP-Mirror","author_avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","tags":"shell-mcp-server,secure-shell,AI-integration","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/MCP-Mirror/blazickjp_shell-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/b9627c4229a8c39d49bc0c1722f968a714c8e21f3678a47e9ea14da8cae47716/68747470733a2f2f62616467652e667572792e696f2f70792f7368656c6c2d6d63702d7365727665722e737667","type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools