Pandora's Shell

Name: Pandora's Shell
Author: Zelaron

@Zelaron

代码仓库

关于 Pandora's Shell

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

基本信息

分类

开发工具

许可证

MIT

运行时

python

传输方式

stdio

发布者

Zelaron

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

Execute any shell command and return its output

概览

What is Pandora's Shell?

An MCP server that empowers AI assistants to execute terminal commands on your system with full access. It is compatible with any AI assistant supporting the Model Context Protocol, with setup instructions tailored for Claude Desktop.

How to use Pandora's Shell?

Install prerequisites (Python 3.10+, Git, uv), clone the repository, create a virtual environment, install dependencies, and then configure the claude_desktop_config.json file with the correct paths to the executor script. After restarting Claude Desktop, the server appears in the Installed MCP Servers list.

Key features of Pandora's Shell

Execute any shell command with full system access
Capture command output (stdout and stderr)
Set working directory for command execution
Handle command timeouts (5-minute timeout)
Returns exit code, standard output, and standard error

Use cases of Pandora's Shell

Run pwd to determine the current working directory
List files in the user's home directory
Identify files larger than 200 MB on the system
Execute any shell command an AI assistant requests

FAQ from Pandora's Shell

Is it safe to use Pandora's Shell?

No. This server grants AI assistants unrestricted ability to execute terminal commands with your user privileges. Only use in controlled environments like virtual machines (VMs) or development systems you can afford to rebuild. Never use on production systems or machines with sensitive data.

What are the system requirements?

Python 3.10 or higher, Git, and uv for package management. Claude Desktop with an active Claude Pro/Enterprise subscription is used for the configuration example.

How do I configure Pandora's Shell for Claude Desktop?

Create or edit claude_desktop_config.json in the correct configuration directory (e.g., %APPDATA%\Claude\ on Windows or ~/Library/Application Support/Claude/ on macOS). Set the command to the Python interpreter inside your virtual environment and args to the executor script path, with PYTHONPATH set to the src directory.

How do I verify the server is running successfully?

Restart Claude Desktop completely, then click the 🔌 icon to check if "pandoras-shell" appears in the Installed MCP Servers list. If not, inspect the MCP logs (e.g., %APPDATA%\Claude\Logs\mcp*.log on Windows).

What happens if a command times out?

The server sets a 5-minute timeout for command execution. If the timeout is reached, the command is terminated and error handling is applied.

开发工具分类下的更多 MCP 服务器

TalkToFigma

sonnylazuardi

TalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

6.9K