zelaron/pandoras-shell

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

23 stars 5 forks 质量 65 趋势 10MIT

Repository Install

MCP服务器使AI助手能够通过安全的壳层接口执行终端命令

概览

⚠️ ：这个MCP服务器赋予AI助手在你系统上执行终端命令的无限制能力。一个MCP服务器，赋能AI助手在您的系统上执行终端命令。由于该软件提供不受限制的访问权限，务必负责任地使用该软件，并充分了解其中的安全风险。：该服务器兼容任何支持模型上下文协议（MCP）的AI助手。提供的配置和设置说明专为Claude Desktop量身定制，Claude Desktop对所有MCP功能提供全面支持。

概述（AI 翻译）

⚠️ 重要安全警告：该MCP服务器赋予AI助手无限制地执行终端命令的能力。仅在受控环境中使用，如虚拟机（VM）或你有能力重建的开发系统。

关于

一个MCP服务器，赋能AI助手在您的系统上执行终端命令。由于该软件提供不受限制的访问权限，务必负责任地使用该软件，并充分了解其中的安全风险。

注意：本服务器兼容任何支持模型上下文协议（MCP）的AI助手。提供的配置和设置说明专为Claude Desktop量身定制，全面支持所有MCP功能。

特色

执行任何带有完整系统访问权限的 shell 命令
捕获命令输出（stdout/stderr）
设置工作目录
处理命令超时

API

工具

execute_command
执行任意shell命令并返回其输出
输入：
command（字符串）：执行命令
directory（字符串，可选）：工作目录
退场次数：
命令退出代码
标准输出
标准误

本页由 AI 翻译，技术细节请以原文为准。

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 新手？先看 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"
      }
    }
  }
}