Super Shell MCP

🚀 スーパーシェル（Super Shell）

スーパーシェル（Super Shell）は、開発者やシステム管理者の作業効率を向上させるために設計された強力なコマンドシェルツールです。Windows、macOS、Linux といった複数のプラットフォームで動作し、コマンド管理、権限制御、ログ記録、リモート設定などの豊富な機能モジュールを提供します。

🚀 クイックスタート

スーパーシェル（Super Shell）は、開発者やシステム管理者の作業効率を向上させるために設計された強力なコマンドシェルツールです。このツールは、Windows、macOS、Linux といった複数のプラットフォームで動作し、コマンド管理、権限制御、ログ記録、リモート設定などの豊富な機能モジュールを提供します。

✨ 主な機能

コマンド管理

スーパーシェルは強力なコマンド制御機能を提供し、以下の操作をサポートします。

• ホワイトリストとブラックリストの戦略：whitelist と blacklist の設定を通じて、特定のコマンドの実行を制限または許可します。
• タイムアウト制御：応答のない長時間のコマンドがシステムリソースを占有するのを防ぎます。

権限制御

スーパーシェルは、ユーザーロールと環境変数に基づいた柔軟な権限管理を提供します。

1. ユーザー認証：
   • トークン認証、OAuth など、複数の認証方式をサポートします。
2. アクセス制御リスト（ACL）：
   • 細かい粒度のリソースアクセス権限を定義します。

ログシステム

スーパーシェルには、サーバーの状態をデバッグおよび監視するための完全なログ記録機能が組み込まれています。

1. ログファイルの位置：
   • デフォルトのパス：logs/super - shell - mcp.log
   • ログディレクトリを自動的に作成し、.gitkeep ファイルを含めてディレクトリを追跡します。
2. ログレベル：
   • INFO：一般的な操作情報を記録します。
   • DEBUG：詳細なデバッグ情報を記録します。
   • ERROR：エラー条件と例外を記録します。

クロスプラットフォームサポート

スーパーシェルは以下のオペレーティングシステムをサポートします。

• Windows：
  • cmd.exe または PowerShell を使用してコマンドを実行します。
  • JSON では、パス区切り文字（バックスラッシュ \）をダブルバックスラッシュ (\\) としてエスケープする必要があることに注意してください。
• macOS/Linux：
  • デフォルトでは /bin/bash またはユーザーが指定したシェルを使用します。

📦 インストール

インストール

1. npm を通じたインストール：

   npm install -g super-shell-mcp
   

2. 手動インストール： 圧縮ファイルを指定されたディレクトリに解凍し、実行可能ファイルに適切な権限が付与されていることを確認してください。

設定

スーパーシェルは、設定ファイル config.json を使用してカスタマイズできます。以下は一般的な設定オプションです。

{
  "shellType": "auto", // シェルタイプを自動検出し、"cmd"、"bash"、"powershell" をサポートします
  "timeout": 30000,    // コマンド実行のタイムアウト時間（ミリ秒）
  "whitelist": ["ls", "cd", "cp", "rm"], // 許可されるコマンドのリスト
  "blacklist": ["sudo", "su"], // 禁止されるコマンドのリスト
  "logLevel": "INFO" // ログレベル：INFO、DEBUG、ERROR
}

💻 使用例

基本的な使用法

# 例：Windows で PowerShell を使用するようにスーパーシェルを設定する
{
  "shellType": "powershell",
  "workingDirectory": "C:\\Users\\CurrentUser\\Documents"
}

高度な使用法

# 例：簡単なファイル操作を実行する
super-shell-mcp.exe -c "ls" // 現在のディレクトリのファイルを一覧表示する
super-shell-mcp.exe -c "cd .." // 上のディレクトリに移動する

📚 ドキュメント

Windows システム

• 問題：パス区切り文字のエラー。
  • 解決策：JSON 設定では、パス区切り文字にダブルバックスラッシュ (\\) を使用する必要があります。

macOS/Linux システム

• 問題：コマンドが見つからない。
  • 解決策：環境変数の設定が正しいことを確認し、コマンドがシステムの PATH に含まれていることを確認してください。

📄 ライセンス

スーパーシェルは MIT ライセンスに従います。

MIT License

Copyright (c) [year] [copyright holder]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

まとめ

スーパーシェル（Super Shell）は、複数のオペレーティングシステムと開発環境に適した、機能が豊富で設定が容易なコマンドシェルツールです。柔軟な権限制御とログ記録機能により、作業効率を大幅に向上させ、システム管理を簡素化することができます。