run_terminal_command

診断とシステム · macOS · Windows

効果: 実行. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

ユーザーの Mac でシェルコマンドを実行し、その出力を返します。常に有効です。LMCP が読み取り専用モードのときは無効になります。取り消せない 3 種類のコマンドは拒否されます。ディスクのフォーマットや上書き（mkfs、newfs、fdisk、diskutil erase/partition、ディスクデバイスへの/からの dd）、システムフォルダ、ユーザーのホームフォルダ、またはそのデータフォルダ（Documents、Desktop、Downloads、Library、Pictures、Movies、Music）の再帰的な削除、それらのフォルダ直下のすべての再帰的な削除、およびコマンドのテキストから対象やフォルダが確定できない場合（変数、コマンド置換、サブシェル内の cd）の再帰的な削除、そしてフォークボムです。資格情報の場所（キーチェーン、~/.ssh の秘密鍵、~/.aws、~/.config/gh、ブラウザのログイン情報、他のユーザーのホーム）を指定するコマンド、あとでコードを実行するファイル（LaunchAgents、シェルの起動ファイル、AI クライアントのフォルダ）に書き込むコマンド、スクリプトで別のアプリを操作するコマンド、スクリプトやターミナルアプリを開くコマンド、システムサービスや電源を制御するコマンド、ダウンロードしたスクリプトをシェルにパイプするコマンド、デバイスファイルに書き込むコマンド、システムパスの権限を再帰的に変更するコマンドは拒否されません。プレビューと結果に、その内容を説明する警告が付きます。確認する前に、ユーザーがまさにこれを求めた場合を除き、何を読み取り、何を変更するかをユーザーに伝えてください。警告はコマンドのテキストだけを読むため、パスを隠すコマンドには警告が付きません。コマンドは Local MCP 自身だけを保護する macOS サンドボックス内で実行されます。ターミナルは Local MCP 自身のファイル（設定とトークン、バイナリ、アクティビティログ、メッセージングと Web のセッション、起動項目）をパスで開いたり変更したりできず、そのソケットとも通信できず、ユーザーが Read または Write のボックスをオフにしたアカウントのファイルを開くこともできません。この制限を解除する設定はありません。このサンドボックスのため、ps と top 以外の setuid システムプログラム（sudo、su、crontab、at、traceroute）は起動できません。警告はコマンドの実行前にその旨を伝え、`log` コマンドは実行されません。サンドボックス内で SwiftPM を使うには --disable-sandbox が必要です。破壊的な操作です。最初にコマンドのプレビューを返し、confirm:true を渡すと実際に実行します。出力と実行時間には上限があります。

必須入力

command

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — macOS

{
  "properties": {
    "command": {
      "description": "The shell command to run (a single command line, executed with /bin/zsh -lc).",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually run. Without it, a preview of the command is returned.",
      "type": "boolean"
    },
    "timeout_seconds": {
      "description": "Max seconds to run before it is terminated (default 20, max 60).",
      "type": "integer"
    },
    "working_dir": {
      "description": "Optional absolute working directory. Defaults to the user's home directory.",
      "type": "string"
    }
  },
  "required": [
    "command"
  ],
  "type": "object"
}

ドキュメント例

run_terminal_command のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{
  "command": "echo Hello from LMCP",
  "confirm": false
}

Windows

目的

ユーザーのコンピューターでシェルコマンドを実行します。一部のシステムレベルのコマンド（sudo/権限昇格、システムパスやホームパスの再帰的な削除、ディスクのフォーマット、シャットダウン/再起動、ダウンロードしたスクリプトをシェルにパイプするもの、フォークボム）は拒否されます。破壊的な操作です。最初にコマンドのプレビューを返し、confirm:true を渡すと実際に実行します。出力と実行時間には上限があります。Windows ではコマンドは `cmd /c` 経由で、それ以外では `sh -c` 経由で実行されます。

必須入力

command

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — Windows

{
  "properties": {
    "command": {
      "description": "The shell command to run (a single command line).",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually run. Without it, a preview of the command is returned.",
      "type": "boolean"
    },
    "timeout_seconds": {
      "description": "Max seconds to run before it is terminated (default 30, max 60).",
      "type": "integer"
    },
    "working_dir": {
      "description": "Optional absolute working directory. Defaults to the user's home directory.",
      "type": "string"
    }
  },
  "required": [
    "command"
  ],
  "type": "object"
}

ドキュメント例

{
  "command": "echo Hello from LMCP",
  "confirm": false
}