Pandora's Shell

Pandora's Shell

⚠️ 重要なセキュリティ警告：この MCP サーバーを使用すると、AI アシスタントがシステム上でターミナルコマンドを無制限に実行できるようになります。仮想マシン（VM）や、再構築しても問題のない開発環境など、管理された環境でのみ使用してください。

概要

AI アシスタントがシステム上でターミナルコマンドを実行できるようにする MCP サーバーです。無制限のアクセスが可能になるため、このソフトウェアは責任を持って使用し、セキュリティリスクを十分に理解することが重要です。

注：このサーバーは、Model Context Protocol（MCP）をサポートするあらゆる AI アシスタントと互換性があります。提供されている設定およびセットアップ手順は、すべての MCP 機能を幅広くサポートする Claude Desktop 向けに調整されています。

機能

• システムへのフルアクセスで、あらゆるシェルコマンドを実行
• コマンドの出力（stdout/stderr）を取得
• 作業ディレクトリを設定
• コマンドのタイムアウトを処理

API

ツール

• execute_command
  • 任意のシェルコマンドを実行し、その出力を返します
  • 入力：
    • command（string）：実行するコマンド
    • directory（string、任意）：作業ディレクトリ
  • 戻り値：
    • コマンドの終了コード
    • 標準出力
    • 標準エラー出力
  • 機能：
    • 5 分のタイムアウト
    • 作業ディレクトリのサポート
    • エラー処理

インストール

前提条件

• Claude Desktop と有効な Claude Pro/Enterprise サブスクリプション
  • ダウンロード先：Claude AI
• Python 3.10 以上
• Git
• uv（パッケージ管理に必要）

Windows へのインストール

1. 前提条件をインストールします：

   オプション A - winget を使用する場合（システムで利用可能な場合）：

   winget install python git
   

   オプション B - 手動でインストールする場合（推奨）：

   • python.org から Python をダウンロードしてインストールします
   • git-scm.com から Git をダウンロードしてインストールします

2. uv をインストールします：

   管理者としてコマンドプロンプト（cmd.exe）を開き、次を実行します：

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

   問題が発生した場合は、変更を反映するためにターミナルまたはコンピューターを再起動する必要があるかもしれません。

3. プロジェクトをクローンしてセットアップします：

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

   次に、仮想環境を作成します。以下のコマンドを順に試し、動作するものを使用してください：

   python -m venv venv
   

   うまくいかない場合は、次を試してください：

   python3 -m venv venv
   

   次に、環境を有効化します：

   venv\Scripts\activate
   

4. 依存関係をインストールします：

   uv pip install mcp
   pip install -e .
   

注：python.org から Python をインストールした場合、通常は python を使用します。winget または Microsoft Store 経由でインストールした場合は、python3 を使用する必要があるかもしれません。どちらかが動作しない場合は、両方のコマンドを試してください。

macOS へのインストール

1. 前提条件をインストールします：

   brew install python git uv
   

2. プロジェクトをクローンしてセットアップします：

   git clone https://github.com/Zelaron/Pandoras-Shell.git
   cd Pandoras-Shell
   python3 -m venv venv
   source venv/bin/activate
   

3. 依存関係をインストールします：

   uv pip install mcp
   pip install -e .
   

設定

Windows

正しい設定ディレクトリを特定します。以下のパスを順に試してください：

1. %APPDATA%\Claude\（通常は C:\Users\[YourUsername]\AppData\Roaming\Claude\）
2. %LOCALAPPDATA%\AnthropicClaude\（通常は C:\Users\[YourUsername]\AppData\Local\AnthropicClaude\）

正しいディレクトリに claude_desktop_config.json を作成または編集します：

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

Windows での重要な注意事項：

• パスにはバックスラッシュ（\）ではなく、スラッシュ（/）を使用してください
• [YourUsername] を実際の Windows ユーザー名に置き換えてください
• ファイル名は必ず claude_desktop_config.json にしてください
• 設定場所の候補が両方存在する場合は、成功するまでそれぞれを試してください

macOS

~/Library/Application Support/Claude/claude_desktop_config.json を作成または編集します：

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

macOS での重要な注意事項：

• [YourUsername] を実際のユーザー名に置き換えてください
• 必要に応じて、/Users/[YourUsername] の代わりに $HOME を使用できます
• ファイル名は必ず claude_desktop_config.json にしてください
• command のパスは、システムの Python ではなく、仮想環境内の Python インタープリター（venv/bin/python）を指定してください

設定後

1. Claude Desktop を完全に再起動します（ウィンドウを閉じるだけでなく、終了してください）。
2. 🔌 アイコンをクリックし、「Installed MCP Servers」リストにサーバーが表示されていることを確認します。
3. サーバーが表示されない場合は、Claude のログを確認します。
   • Windows：%APPDATA%\Claude\Logs\mcp*.log または %LOCALAPPDATA%\AnthropicClaude\Logs\mcp*.log
   • macOS：~/Library/Logs/Claude/mcp*.log

セキュリティに関する注意事項

このサーバーは、ユーザーの権限でコマンドを実行します。次の注意事項を守ってください。

• 仮想マシンまたは使い捨ての開発環境でのみ使用してください。
• 本番システムや機密データを含むマシンでは、絶対に使用しないでください。
• 必要に応じて、コマンドの制限を実装することを検討してください。
• システムへのアクセスとアクティビティを監視してください。
• 重要なデータのバックアップを保管してください。

免責事項：このソフトウェアの使用によって生じたいかなる損害や損失についても、開発者は責任を負いません。ご自身の責任でご使用ください。

トラブルシューティング

問題が発生した場合は、次の項目を確認してください。

1. ログを確認する：

   • Windows：%APPDATA%\Claude\Logs\mcp*.log または %LOCALAPPDATA%\AnthropicClaude\Logs\mcp*.log
   • macOS：~/Library/Logs/Claude/mcp*.log

2. インストールを確認する：

   • uv が正しくインストールされ、PATH に含まれていることを確認します。
   • mcp パッケージがインストールされていることを確認します：pip show mcp。
   • Python のバージョンが 3.10 以上であることを確認します。

3. 設定の問題：

   • claude_desktop_config.json 内のすべてのパスを再確認します。
   • JSON の構文が有効であることを確認します。
   • OS に適したパス区切り文字を使用していることを確認します。
   • 設定ファイルが正しい場所にあることを確認します。

4. 環境の問題：

   • virtualenv を使用している場合は、有効化されていることを確認します。
   • PYTHONPATH が正しく設定されていることを確認します。
   • ファイルのアクセス許可を確認します。

5. サーバーを手動でテストする：

   # First, make sure you're in the Pandoras-Shell directory:
   cd /path/to/cloned/Pandoras-Shell
   
   # For macOS:
   ./venv/bin/python src/pandoras_shell/executor.py
   
   # For Windows:
   .\venv\Scripts\python.exe src\pandoras_shell\executor.py
   
   # The executor will appear to hang with no output - this is normal.
   # It's waiting for connections from Claude Desktop.
   # Use Ctrl+C to stop it.
   

6. 接続の問題：

   • 「Could not connect to MCP server」エラーが表示される場合は、設定ファイルで仮想環境の Python インタープリターを使用していることを確認します。
   • macOS の場合：/path/to/cloned/Pandoras-Shell/venv/bin/python を使用します。
   • Windows の場合：C:/path/to/cloned/Pandoras-Shell/venv/Scripts/python.exe を使用します。

テスト

セットアップ後、Claude Desktop で次のコマンドを試してください。

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?