Pandora's Shell

by Zelaron

22 311 downloads Not rated yet MIT
GitHub

About

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

Details

License
MIT

Explore

- Execute any shell command with full system access
- Capture command output (stdout/stderr)
- Set working directory
- Handle command timeouts

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Pandora's Shell
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Prerequisites

- Claude Desktop with an active Claude Pro/Enterprise subscription
- Download from: Claude AI
- Python 3.10 or higher
- Git
- uv (required for package management)

command

(string): Command to execute

directory

(string, optional): Working directory

- execute_command
- Execute any shell command and return its output
- Inputs:
- command (string): Command to execute
- directory (string, optional): Working directory
- Returns:
- Command exit code
- Standard output
- Standard error
- Features:
- 5-minute timeout
- Working directory support
- Error handling

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "pandora's shell": {
            "Pandoras-Shell": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

McpServers

{
    "Pandoras-Shell": {
        "command": "python3",
        "args": [
            "-m",
            "venv",
            "venv"
        ]
    }
}

⚠️ IMPORTANT SECURITY WARNING: This MCP server grants AI assistants unrestricted ability to execute terminal commands on your system. Only use in controlled environments like virtual machines (VMs) or development systems you can afford to rebuild.

About

An MCP server that empowers AI assistants to execute terminal commands on your system. Due to the unrestricted access this provides, it's crucial to use this software responsibly and be fully aware of the security risks involved.

Note: This server is compatible with any AI assistant that supports the Model Context Protocol (MCP). The provided configuration and setup instructions are specifically tailored for Claude Desktop, which offers comprehensive support for all MCP features.

Features

- Execute any shell command with full system access
- Capture command output (stdout/stderr)
- Set working directory
- Handle command timeouts

API

Tools

- execute_command
- Execute any shell command and return its output
- Inputs:
- command (string): Command to execute
- directory (string, optional): Working directory
- Returns:
- Command exit code
- Standard output
- Standard error
- Features:
- 5-minute timeout
- Working directory support
- Error handling

Installation

Prerequisites

- Claude Desktop with an active Claude Pro/Enterprise subscription
- Download from: Claude AI
- Python 3.10 or higher
- Git
- uv (required for package management)

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.