zelaron/pandoras-shell

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

23 stars 5 forks Качество 65 Тренд 10MIT

Repository Install

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

Обзор

⚠️ : This MCP server grants AI assistants unrestricted ability to execute terminal commands on your system. 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. : 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.

README

Показан фрагмент оригинального README. Открыть оригинал.

Pandora’s Shell

⚠️ 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)

Windows Installation

Install Prerequisites:

Option A - Using winget (if available on your system):
```
winget install python git
```
Option B - Manual installation (recommended):
- Download and install Python from python.org
- Download and install Git from git-scm.com
Install uv:

Open Command Prompt (cmd.exe) as administrator and run:
```
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```
If you encounter any issues, you may need to restart your terminal or computer for the changes to take effect.
Clone and set up the project:
```
git clone https://github.com/Zelaron/Pandoras-Shell.git
cd Pandoras-Shell
```
Then create a virtual environment. Try these commands in order until one works:
```
python -m venv venv
```
If that doesn’t work, try:
```
python3 -m venv venv
```
Then activate the environment:
```
venv\Scripts\activate
```
Install dependencies:
```
uv pip install mcp
pip install -e .
```

Note: If you installed Python from python.org, you’ll typically use python. If you installed via winget or from the Microsoft Store, you might need to use python3. Try both commands if one doesn’t work.

macOS Installation

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "pandoras-shell": {
      "command": "C:/path/to/cloned/Pandoras-Shell/venv/Scripts/python.exe",
      "args": [
        "C:/path/to/cloned/Pandoras-Shell/src/pandoras_shell/executor.py"
      ],
      "env": {
        "PYTHONPATH": "C:/path/to/cloned/Pandoras-Shell/src"
      }
    }
  }
}