drio
Open app

Pandora's Shell

Source

MCP server enabling AI assistants to execute terminal commands through a secure shell interface

Catalog onlyCatalog onlySTDIO

Overview

Pandora's Shell is an MCP server that enables AI assistants to execute terminal commands through a secure shell interface.

To use Pandora's Shell, set it up in a controlled environment, ensuring that your AI assistant is compatible with the Model Context Protocol (MCP), and follow the configuration instructions specific to your operating system.

  • Execute any shell command with full system access. - Capture command output including both standard output and error. - Set working directories and handle command timeouts efficiently.
  1. Running system commands via an AI assistant in virtual machines.
  2. Integrating AI functionalities with terminal operations for automation tasks.
  3. Experimenting with command execution in development environments for testing purposes.

Add to your AI client

Use these steps to connect Pandora's Shell 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": {
    "pandoras-shell-zelaron": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-pandoras-shell-zelaron"
      ]
    }
  }
}

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": {
    "pandoras-shell-zelaron": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-pandoras-shell-zelaron"
      ]
    }
  }
}

Claude Code

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

.mcp.json (project root)

{
  "mcpServers": {
    "pandoras-shell-zelaron": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-pandoras-shell-zelaron"
      ]
    }
  }
}

VS Code (Copilot)

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

.vscode/mcp.json

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

Windsurf

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pandoras-shell-zelaron": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-pandoras-shell-zelaron"
      ]
    }
  }
}

Cline

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

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "pandoras-shell-zelaron": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-pandoras-shell-zelaron"
      ]
    }
  }
}

FAQ

Is it safe to use Pandora's Shell on my main machine?

No! It's strongly advised to use Pandora's Shell only in controlled environments like virtual machines or development systems that can be easily rebuilt.

What are the prerequisites to install Pandora's Shell?

You need Claude Desktop, Python 3.10 or higher, Git, and uv for package management.

How does error handling work in Pandora's Shell?

The server captures standard output and standard error, allowing you to debug command failures effectively.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":69,"uuid":" 0d37e8a2-c85f-448c-be14-3e9021a71f8b","name":"Pandoras-Shell","title":"Pandora's Shell","description":"MCP server enabling AI assistants to execute terminal commands through a secure shell interface","avatar_url":"https://avatars.githubusercontent.com/u/2899300?v=4","created_at":"2024-12-06T08:19:02.000Z","updated_at":"2024-12-13T07:46:58.604Z","status":"created","author_name":"Zelaron","author_avatar_url":"https://avatars.githubusercontent.com/u/2899300?v=4","tags":"[]","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/Zelaron/Pandoras-Shell","target":"_self","content":"$29","summary":"$2a","img_url":null,"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"}]]}]

Research and data