zelaron/pandoras-shell

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

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

GitHub에서 전체 README 보기

설치

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"
      }
    }
  }
}