Pandora's Shell：让AI助手执行终端命令的MCP服务器

项目简介

Pandora's Shell 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在赋予支持 MCP 协议的AI助手（如 Claude Desktop）在你的本地系统上执行终端命令的能力。请务必注意，由于该服务器提供了对系统命令执行的无限制访问，存在严重的安全风险，请仅在虚拟机或可重建的开发环境中使用。

主要功能点

执行任意 Shell 命令：允许 AI 助手执行任何终端命令，实现与本地系统的交互。
捕获命令输出：返回命令的标准输出 (stdout) 和标准错误 (stderr)，方便 AI 助手理解命令执行结果。
设置工作目录：支持指定命令执行的工作目录，提供更灵活的文件系统操作。
命令超时处理：为命令执行设置超时时间（5分钟），防止长时间运行的命令阻塞服务器。

安装步骤

前提条件：

Claude Desktop：已安装并登录 Claude Pro/Enterprise 订阅。
- 下载地址：Claude AI
Python 3.10 或更高版本
Git
uv (包管理器，用于更快的Python包安装)

安装步骤 (以 Windows 为例，macOS 类似)：

安装前提条件：
- Windows: 推荐使用手动安装方式，从 python.org 和 git-scm.com 下载并安装 Python 和 Git。
- macOS: 可以使用 'brew install python git uv' 命令安装。

安装 uv：

Windows: 以管理员身份打开命令提示符 ('cmd.exe')，运行命令：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

macOS: 'brew install uv'

克隆项目并设置：打开终端或命令提示符，执行以下命令：

git clone https://github.com/Zelaron/Pandoras-Shell.git
cd Pandoras-Shell

创建并激活 Python 虚拟环境：

python -m venv venv  # Windows 可能需要使用 python3
venv\Scripts\activate  # Windows
source venv/bin/activate # macOS

安装依赖：在激活的虚拟环境中，运行命令安装必要的 Python 包：

uv pip install mcp
pip install -e .

服务器配置

要让 Claude Desktop 连接到 Pandora's Shell 服务器，需要配置 Claude Desktop 的配置文件 'claude_desktop_config.json'。

配置文件位置：

Windows: 通常在 '%APPDATA%\Claude' 或 '%LOCALAPPDATA%\AnthropicClaude' 目录下 (例如 'C:\Users[YourUsername]\AppData\Roaming\Claude' 或 'C:\Users[YourUsername]\AppData\Local\AnthropicClaude')
macOS: '~/Library/Application Support/Claude/'

配置内容 (JSON 格式)：

在 'claude_desktop_config.json' 文件中添加或修改 'mcpServers' 部分，添加 'pandoras-shell' 服务器的配置。

{
  "mcpServers": {
    "pandoras-shell": {
      "command": "C:/path/to/cloned/Pandoras-Shell/venv/Scripts/python.exe",  // Windows Python 解释器路径 (虚拟环境内)
      "args": [
        "C:/path/to/cloned/Pandoras-Shell/src/pandoras_shell/executor.py" // 服务器执行脚本路径
      ],
      "env": {
        "PYTHONPATH": "C:/path/to/cloned/Pandoras-Shell/src" // Python 模块搜索路径
      }
    }
  }
}

重要配置说明：

'command': 指向你克隆的 'Pandoras-Shell' 项目中虚拟环境内的 Python 解释器路径。
'args': 包含服务器执行脚本 'executor.py' 的路径。
'env.PYTHONPATH': 指定 Python 模块搜索路径，确保服务器能找到 'pandoras_shell' 模块。
路径分隔符: Windows 路径使用正斜杠 '/'。
替换路径: 将 'C:/path/to/cloned/Pandoras-Shell' 替换为你实际克隆的项目路径。
重启 Claude Desktop: 配置完成后，完全退出并重启 Claude Desktop 使配置生效。

基本使用方法

配置完成后，在 Claude Desktop 中，你可以通过自然语言指令来调用 'execute_command' 工具，例如：

Can you run 'pwd' and tell me what directory we're in?

或

Can you list the files in my home directory? Which of them are larger than 200 MB?

Claude Desktop 会将这些指令转换为对 Pandora's Shell 服务器的工具调用请求，服务器执行命令并将结果返回给 Claude Desktop。

安全警告： 再次强调，请务必在安全可控的环境（如虚拟机）中使用 Pandora's Shell，并充分了解潜在的安全风险。

关键词