Windows CLI MCP サーバー

Windowsシステム上で安全なコマンドラインインタラクションを実現するMCPサーバー。PowerShell、CMD、Git Bashシェル、そしてSSH経由のリモートシステムへの制御されたアクセスを可能にします。MCPクライアント（ Claude Desktopなど）が、 Open Interpreterと同様にシステム上で操作を実行できるようになります。

[!重要] このMCPサーバーは、SSH経由でシステムのコマンドラインインターフェースとリモートシステムへの直接アクセスを提供します。有効にすると、ファイル、環境変数、コマンド実行機能、およびリモートサーバー管理へのアクセスが許可されます。
許可されたパスとSSH接続を確認して制限する
ディレクトリ制限を有効にする
コマンドブロックを構成する
セキュリティへの影響を考慮する
詳細については、構成を参照してください。

特徴
Claude Desktopでの使用
構成
API
- ツール
- リソース
セキュリティに関する考慮事項
ライセンス

特徴

マルチシェルのサポート: PowerShell、コマンドプロンプト (CMD)、Git Bash でコマンドを実行します。
SSHサポート: SSH経由でリモートシステム上でコマンドを実行する
リソースの公開: SSH 接続、現在のディレクトリ、および構成を MCP リソースとして表示します。
セキュリティ管理:
- コマンドと SSH コマンドのブロック (フルパス、大文字と小文字の区別)
- 作業ディレクトリの検証
- 最大コマンド長制限
- コマンドのログ記録と履歴の追跡
- スマートな引数検証
設定可能:
- カスタムセキュリティルール
- シェル固有の設定
- SSH接続プロファイル
- パス制限
- ブロックされたコマンドリスト

サーバーが MCP クライアントに提供するツールとリソースの詳細については、 APIセクションを参照してください。

注: サーバーは、設定されたディレクトリ内、許可されたコマンド、および設定された SSH 接続での操作のみを許可します。

Claude Desktopでの使用

これをclaude_desktop_config.jsonに追加します:

{
  "mcpServers": {
    "windows-cli": {
      "command": "npx",
      "args": ["-y", "@simonb97/server-win-cli"]
    }
  }
}

特定の設定ファイルで使用する場合は、 --configフラグを追加します。

{
  "mcpServers": {
    "windows-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@simonb97/server-win-cli",
        "--config",
        "path/to/your/config.json"
      ]
    }
  }
}

設定後、次のことが可能になります。

利用可能なツールを使用して直接コマンドを実行する
リソースセクションで構成されたSSH接続とサーバー構成を表示します。
提供されたツールを使用してSSH接続を管理する

構成

サーバーはJSON構成ファイルを使用して動作をカスタマイズします。セキュリティ制御、シェル構成、SSH接続の設定を指定できます。

デフォルトの設定ファイルを作成するには、次のいずれかを実行します。

a) config.json.exampleをconfig.jsonにコピーするか、

**b)**実行:

npx @simonb97/server-win-cli --init-config ./config.json

次に、「Claude Desktop での使用」セクションで説明されているように、 --configフラグを設定して構成ファイルを指定します。

構成場所

サーバーは、次の場所 (順番に) で構成を検索します。

--configフラグで指定されたパス
現在のディレクトリの./config.json
ユーザーのホームディレクトリ内の ~/.win-cli-mcp/config.json

設定ファイルが見つからない場合、サーバーはデフォルトの（制限された）設定を使用します。

デフォルト設定

注：デフォルト設定は制限を厳しくし、セキュリティを強化するように設計されています。各設定の詳細については、「構成設定」セクションをご覧ください。

{
  "security": {
    "maxCommandLength": 2000,
    "blockedCommands": [
      "rm",
      "del",
      "rmdir",
      "format",
      "shutdown",
      "restart",
      "reg",
      "regedit",
      "net",
      "netsh",
      "takeown",
      "icacls"
    ],
    "blockedArguments": [
      "--exec",
      "-e",
      "/c",
      "-enc",
      "-encodedcommand",
      "-command",
      "--interactive",
      "-i",
      "--login",
      "--system"
    ],
    "allowedPaths": ["User's home directory", "Current working directory"],
    "restrictWorkingDirectory": true,
    "logCommands": true,
    "maxHistorySize": 1000,
    "commandTimeout": 30,
    "enableInjectionProtection": true
  },
  "shells": {
    "powershell": {
      "enabled": true,
      "command": "powershell.exe",
      "args": ["-NoProfile", "-NonInteractive", "-Command"],
      "blockedOperators": ["&", "|", ";", "`"]
    },
    "cmd": {
      "enabled": true,
      "command": "cmd.exe",
      "args": ["/c"],
      "blockedOperators": ["&", "|", ";", "`"]
    },
    "gitbash": {
      "enabled": true,
      "command": "C:\\Program Files\\Git\\bin\\bash.exe",
      "args": ["-c"],
      "blockedOperators": ["&", "|", ";", "`"]
    }
  },
  "ssh": {
    "enabled": false,
    "defaultTimeout": 30,
    "maxConcurrentSessions": 5,
    "keepaliveInterval": 10000,
    "keepaliveCountMax": 3,
    "readyTimeout": 20000,
    "connections": {}
  }
}

構成設定

設定ファイルは、 security 、 shells 、 ssh 3 つの主要なセクションに分かれています。

セキュリティ設定

{
  "security": {
    // Maximum allowed length for any command
    "maxCommandLength": 1000,

    // Commands to block - blocks both direct use and full paths
    // Example: "rm" blocks both "rm" and "C:\\Windows\\System32\\rm.exe"
    // Case-insensitive: "del" blocks "DEL.EXE", "del.cmd", etc.
    "blockedCommands": [
      "rm", // Delete files
      "del", // Delete files
      "rmdir", // Delete directories
      "format", // Format disks
      "shutdown", // Shutdown system
      "restart", // Restart system
      "reg", // Registry editor
      "regedit", // Registry editor
      "net", // Network commands
      "netsh", // Network commands
      "takeown", // Take ownership of files
      "icacls" // Change file permissions
    ],

    // Arguments that will be blocked when used with any command
    // Note: Checks each argument independently - "cd warm_dir" won't be blocked just because "rm" is in blockedCommands
    "blockedArguments": [
      "--exec", // Execution flags
      "-e", // Short execution flags
      "/c", // Command execution in some shells
      "-enc", // PowerShell encoded commands
      "-encodedcommand", // PowerShell encoded commands
      "-command", // Direct PowerShell command execution
      "--interactive", // Interactive mode which might bypass restrictions
      "-i", // Short form of interactive
      "--login", // Login shells might have different permissions
      "--system" // System level operations
    ],

    // List of directories where commands can be executed
    "allowedPaths": ["C:\\Users\\YourUsername", "C:\\Projects"],

    // If true, commands can only run in allowedPaths
    "restrictWorkingDirectory": true,

    // If true, saves command history
    "logCommands": true,

    // Maximum number of commands to keep in history
    "maxHistorySize": 1000,

    // Timeout for command execution in seconds (default: 30)
    "commandTimeout": 30,

    // Enable or disable protection against command injection (covers ;, &, |, \`)
    "enableInjectionProtection": true
  }
}

シェルの構成

{
  "shells": {
    "powershell": {
      // Enable/disable this shell
      "enabled": true,
      // Path to shell executable
      "command": "powershell.exe",
      // Default arguments for the shell
      "args": ["-NoProfile", "-NonInteractive", "-Command"],
      // Optional: Specify which command operators to block
      "blockedOperators": ["&", "|", ";", "`"]  // Block all command chaining
    },
    "cmd": {
      "enabled": true,
      "command": "cmd.exe",
      "args": ["/c"],
      "blockedOperators": ["&", "|", ";", "`"]  // Block all command chaining
    },
    "gitbash": {
      "enabled": true,
      "command": "C:\\Program Files\\Git\\bin\\bash.exe",
      "args": ["-c"],
      "blockedOperators": ["&", "|", ";", "`"]  // Block all command chaining
    }
  }
}

SSH設定

{
  "ssh": {
    // Enable/disable SSH functionality
    "enabled": false,

    // Default timeout for SSH commands in seconds
    "defaultTimeout": 30,

    // Maximum number of concurrent SSH sessions
    "maxConcurrentSessions": 5,

    // Interval for sending keepalive packets (in milliseconds)
    "keepaliveInterval": 10000,

    // Maximum number of failed keepalive attempts before disconnecting
    "keepaliveCountMax": 3,

    // Timeout for establishing SSH connections (in milliseconds)
    "readyTimeout": 20000,

    // SSH connection profiles
    "connections": {
      // NOTE: these examples are not set in the default config!
      // Example: Local Raspberry Pi
      "raspberry-pi": {
        "host": "raspberrypi.local", // Hostname or IP address
        "port": 22, // SSH port
        "username": "pi", // SSH username
        "password": "raspberry", // Password authentication (if not using key)
        "keepaliveInterval": 10000, // Override global keepaliveInterval
        "keepaliveCountMax": 3, // Override global keepaliveCountMax
        "readyTimeout": 20000 // Override global readyTimeout
      },
      // Example: Remote server with key authentication
      "dev-server": {
        "host": "dev.example.com",
        "port": 22,
        "username": "admin",
        "privateKeyPath": "C:\\Users\\YourUsername\\.ssh\\id_rsa", // Path to private key
        "keepaliveInterval": 10000,
        "keepaliveCountMax": 3,
        "readyTimeout": 20000
      }
    }
  }
}

API

ツール

実行コマンド
- 指定されたシェルでコマンドを実行する
- 入力:
  - shell (文字列): 使用するシェル ("powershell", "cmd", または "gitbash")
  - command (文字列): 実行するコマンド
  - workingDir (オプションの文字列): 作業ディレクトリ
- コマンド出力をテキストとして返すか、実行が失敗した場合はエラーメッセージを返します。
コマンド履歴を取得する
- 実行されたコマンドの履歴を取得する
- 入力: limit （オプションの数値）
- タイムスタンプ付きのコマンド履歴を出力とともに返します
ssh_execute
- SSH経由でリモートシステムでコマンドを実行する
- 入力:
  - connectionId (文字列): 使用するSSH接続のID
  - command (文字列): 実行するコマンド
- コマンド出力をテキストとして返すか、実行が失敗した場合はエラーメッセージを返します。
ssh_切断
- SSHサーバーから切断する
- 入力：
  - connectionId (文字列): 切断するSSH接続のID
- 確認メッセージを返す
SSH接続を作成する
- 新しいSSH接続を作成する
- 入力:
  - connectionId (文字列): 新しいSSH接続のID
  - connectionConfig (オブジェクト): ホスト、ポート、ユーザー名、パスワードまたは privateKeyPath を含む接続構成の詳細
- 確認メッセージを返す
read_ssh_connections
- 設定されたすべてのSSH接続を読み取る
- 設定からすべてのSSH接続のリストを返します
アップデート_ssh_接続
- 既存のSSH接続を更新する
- 入力:
  - connectionId (文字列): 更新するSSH接続のID
  - connectionConfig (オブジェクト): 新しい接続構成の詳細
- 確認メッセージを返します
SSH接続の削除
- SSH接続を削除する
- 入力：
  - connectionId (文字列): 削除するSSH接続のID
- 確認メッセージを返す
現在のディレクトリを取得する
- サーバーの現在の作業ディレクトリを取得する
- 現在の作業ディレクトリのパスを返します

リソース

SSH接続
- URI 形式: ssh://{connectionId}
- 機密情報がマスクされた接続の詳細が含まれています
- 構成されたSSH接続ごとに1つのリソース
- 例: ssh://raspberry-pi 「raspberry-pi」接続の設定を表示します
SSH設定
- URI: ssh://config
- 全体的な SSH 構成とすべての接続 (パスワードはマスクされています) が含まれます
- defaultTimeout、maxConcurrentSessions、接続リストなどの設定を表示します
現在のディレクトリ
- URI: cli://currentdir
- CLIサーバーの現在の作業ディレクトリが含まれます
- デフォルトでコマンドが実行されるパスを表示します
CLI設定
- URI: cli://config
- CLI サーバー構成が含まれます (機密データは除く)
- セキュリティ設定、シェル構成、SSH設定を表示します

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

組み込みのセキュリティ機能（常時有効）

次のセキュリティ機能はサーバーにハードコードされており、無効にすることはできません。

大文字と小文字を区別しないコマンドブロッキング: すべてのコマンドブロッキングは大文字と小文字を区別しません (例: 「DEL.EXE」、「del.cmd」などは、blockedCommands に「del」が含まれている場合すべてブロックされます)
スマートパス解析: サーバーは完全なコマンドパスを解析してバイパスの試みを防止します (「rm」がブロックされている場合は「C:\Windows\System32\rm.exe」もブロックします)
コマンド解析インテリジェンス: 誤検知を回避します (例: 「warm_dir」は「rm」が blockedCommands にあるからといってブロックされるわけではありません)
入力検証: すべてのユーザー入力は実行前に検証されます
シェルプロセス管理: プロセスは実行後またはタイムアウト後に適切に終了されます
機密データのマスキング: リソース内のパスワードは自動的にマスクされます (******** に置き換えられます)

設定可能なセキュリティ機能（デフォルトで有効）

これらのセキュリティ機能は、config.json ファイルを通じて構成できます。

コマンドブロッキング: blockedCommands配列で指定されたコマンドがブロックされます (デフォルトでは、rm、del、format などの危険なコマンドが含まれます)
引数のブロック: blockedArguments配列で指定された引数はブロックされます (デフォルトでは潜在的に危険なフラグが含まれます)
コマンドインジェクション保護: コマンドチェーンを防止します ( enableInjectionProtection: trueによりデフォルトで有効)
作業ディレクトリの制限: コマンドの実行を指定されたディレクトリに制限します ( restrictWorkingDirectory: trueによりデフォルトで有効)
コマンドの長さ制限: コマンドの最大長を制限します (デフォルト: 2000 文字)
コマンドタイムアウト: 実行時間が長すぎるコマンドを終了します (デフォルト: 30 秒)
コマンドログ: コマンド履歴を記録します ( logCommands: trueによりデフォルトで有効)

重要なセキュリティ警告

これらは機能ではありませんが、知っておくべき重要なセキュリティ上の考慮事項です。

環境アクセス: コマンドは環境変数にアクセスする可能性があり、そこには機密情報が含まれている可能性があります。
ファイルシステムアクセス: コマンドは許可されたパス内のファイルの読み取り/書き込みが可能です。機密データへのアクセスを防ぐため、 allowedPathsを慎重に構成してください。

ライセンス

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

Windows CLI MCP Server

Integrations