リリスシェル

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

について

Lilith Shellは、セキュリティ制御とテストを強化し、AIアシスタントがシステム上でターミナルコマンドを実行できるようにする、強化されたMCPサーバーです。このサーバーは無制限のアクセスを提供するため、このソフトウェアを責任を持って使用し、関連するセキュリティリスクを十分に認識することが重要です。

注：このサーバーは、モデルコンテキストプロトコル（MCP）をサポートするあらゆるAIアシスタントと互換性があります。提供される設定とセットアップ手順は、すべてのMCP機能を包括的にサポートするClaude Desktop向けに特別にカスタマイズされています。

特徴

• セキュリティ検証付きでシェルコマンドを実行する

• コマンド出力をキャプチャする（stdout/stderr）

• 作業ディレクトリを設定する

• コマンドタイムアウトを処理する

• テスト範囲の改善

• 強化されたセキュリティ制御

• FastMCP統合

API

ツール

• 実行コマンド

  • シェルコマンドを実行し、その出力を返す

  • 入力:

    • command (文字列): 実行するコマンド

    • directory （文字列、オプション）: 作業ディレクトリ

  • 戻り値:

    • コマンド終了コード

    • 標準出力

    • 標準誤差

  • 特徴：

    • 5分間のタイムアウト

    • 作業ディレクトリのサポート

    • エラー処理

    • セキュリティ検証

インストール

前提条件

• 有効な Claude Pro/Enterprise サブスクリプションを備えたClaude Desktop

  • ダウンロード元: Claude AI

• Python 3.10以上

• ギット

• 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/charles-adedotun/Lilith-Shell.git cd Lilith-Shell

   次に仮想環境を作成します。以下のコマンドを順番に試し、どれか1つが動作するか確認してください。

   python -m venv venv

   それでもうまくいかない場合は、次のことを試してください。

   python3 -m venv venv

   次に環境をアクティブ化します。

   venv\Scripts\activate

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

   uv pip install -e ".[dev]"

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

macOSのインストール

1. インストールの前提条件:

   brew install python git uv

2. プロジェクトのクローンを作成してセットアップします。

   git clone https://github.com/charles-adedotun/Lilith-Shell.git cd Lilith-Shell python3 -m venv venv source venv/bin/activate

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

   uv pip install -e ".[dev]"

構成

ウィンドウズ

正しい構成ディレクトリを見つけます。次のパスを順番に試してください。

1. %APPDATA%\Claude\ (通常はC:\Users\[YourUsername]\AppData\Roaming\Claude\ )

2. %LOCALAPPDATA%\AnthropicClaude\ (通常はC:\Users\[YourUsername]\AppData\Local\AnthropicClaude\ )

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

Windows に関する重要な注意事項:

• パスにはバックスラッシュ ( \ ) ではなくスラッシュ ( / ) を使用してください。

• [YourUsername]を実際のWindowsユーザー名に置き換えます

• ファイル名はclaude_desktop_config.jsonと正確に命名する必要があります。

• 両方の設定場所が存在する場合は、成功するまでそれぞれ試してください。

macOS

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

macOS に関する重要な注意事項:

• [YourUsername]を実際のユーザー名に置き換えます

• 必要に応じて、 /Users/[YourUsername]の代わりに$HOMEを使用することもできます。

• ファイル名はclaude_desktop_config.jsonと正確に命名する必要があります。

• commandパスは、システムのPythonではなく、仮想環境内のPythonインタープリター（ venv/bin/python ）を指す必要があります。

設定後

1. Claude Desktop を完全に再起動します (ウィンドウを閉じるだけでなく、終了します)。

2. 🔌 アイコンをクリックして、サーバーが「インストール済み MCP サーバー」リストに表示されていることを確認します。

3. サーバーが表示されない場合は、Claude のログを確認してください。

   • Windows : %APPDATA%\Claude\Logs\mcp*.logまたは%LOCALAPPDATA%\AnthropicClaude\Logs\mcp*.log

   • macOS : ~/Library/Logs/Claude/mcp*.log

セキュリティに関する考慮事項

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

• VM または使い捨ての開発環境でのみ使用してください。

• 実稼働システムや機密データを含むマシンでは使用しないでください。

• 必要に応じてコマンド制限の実装を検討してください。

• システムへのアクセスとアクティビティを監視します。

• 重要なデータのバックアップを保管してください。

免責事項：開発者は、本ソフトウェアの使用に起因するいかなる損害または損失についても責任を負いません。自己責任でご使用ください。

トラブルシューティング

問題が発生した場合:

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 Lilith-Shell directory: cd /path/to/cloned/Lilith-Shell # For macOS: ./venv/bin/python src/lilith_shell/executor.py # For Windows: .\venv\Scripts\python.exe src\lilith_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. 接続の問題:

   • 「MCP サーバーに接続できませんでした」というエラーが表示される場合は、構成ファイルで仮想環境の Python インタープリターを使用していることを確認してください。

   • macOSの場合: /path/to/cloned/Lilith-Shell/venv/bin/pythonを使用します

   • Windowsの場合: C:/path/to/cloned/Lilith-Shell/venv/Scripts/python.exeを使用します

テスト

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

または

謝辞

このプロジェクトは、Christian HäggによるPandoras-Shellのフォークであり、セキュリティ、テスト、機能性が大幅に強化されています。このオリジナルプロジェクトは、Lilith Shellの基盤とインスピレーションを提供しました。