Simonb97 Win Cli MCP Server

🚀 Windows CLI ツールドキュメント

このツールは Windows ベースのコマンドラインインターフェイス (CLI) ソリューションを提供します。コマンドの実行、コマンド履歴の取得、SSH を通じたリモートコマンドの実行など、様々な機能をサポートしています。以下に詳細な技術仕様と使用方法を説明します。

🚀 クイックスタート

このツールを使うことで、Windows 環境でのコマンド実行や SSH を通じたリモート操作が容易になります。以下の各機能を利用して、効率的な作業を行えます。

✨ 主な機能

• execute_command: 指定された Shell 環境でコマンドを実行します。
• get_command_history: 実行済みのコマンド履歴を取得します。
• ssh_execute: SSH プロトコルを通じてリモートデバイスでコマンドを実行します。
• ssh_disconnect: リモート SSH サーバーとの接続を切断します。

📚 ドキュメント

ツール概要

• execute_command: 指定されたシェル環境でコマンドを実行します。
• get_command_history: 実行済みのコマンド履歴を取得します。
• ssh_execute: SSH プロトコルを通じてリモートデバイスでコマンドを実行します。
• ssh_disconnect: リモート SSH サーバーとの接続を切断します。

技術仕様

execute_command

• 入力パラメータ:

  • shell: シェルの種類を指定します（"powershell"、"cmd" または "gitbash"）。
  • command: 実行する具体的なコマンド。
  • workingDir（オプション）: 作業ディレクトリを指定します。デフォルトは現在のディレクトリです。

• 出力:

  • コマンドが正常に実行された場合: コマンドの出力結果を返します。
  • 実行に失敗した場合: エラーメッセージを返します。

get_command_history

• 入力パラメータ:

  • limit（オプションの数値）: 取得する履歴の数の上限を設定します。

• 出力:

  • タイムスタンプ付きのコマンド履歴とそれに対応する出力結果を返します。

ssh_execute

• 入力パラメータ:

  • connectionId: 使用する SSH 接続識別子を指定します。
  • command: リモートデバイスで実行する具体的なコマンド。

• 出力:

  • 正常に実行された場合: コマンドの出力結果を返します。
  • 実行に失敗した場合: エラーメッセージを返します。

ssh_disconnect

• 入力パラメータ:

  • connectionId: 切断する SSH 接続識別子を指定します。

• 出力:

  • 接続が正常に切断されたことを示す確認メッセージを返します。

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

• コマンド制御: 実行可能ファイル名と完全なパスに基づいて特定のコマンドをブロックします。
• 大文字小文字を区別しない: "DEL.EXE" や "del.cmd" などの異なる大文字小文字のコマンドを統一的に処理します。
• スマートなパス解析: パスの置き換えなどによるコマンド制限の回避を防止します。
• 内容分析: コマンド内容を分析することで誤検知を回避します。例えば、"rm" がブロックされていても "warm_dir" は正常に実行できます。
• 危険なパラメータのブロック: リスクを伴う可能性のあるコマンドパラメータをブロックします。
• 注入防止: コマンド注入攻撃を防止するためのオプション機能です。
• ディレクトリ検証: 作業ディレクトリが許可されたパス内にあることを確認します。
• 長さ制限: デフォルトでコマンドの長さに制限を設けます。
• プロセス終了: シェルプロセスが正しく終了することを保証します。
• 入力検証: すべての入力は検証されてから実行されます。
• 環境変数とファイルアクセス: 制御された許可パス内で、機密ディレクトリや環境情報へのアクセスを制限する必要がある場合があります。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細については LICENSE ファイルを参照してください。