BashCommand

Execute and manage bash commands on the mcp-wcgw server. Monitor command status and output, avoid file-related errors by verifying the working directory, and handle long-running tasks efficiently using screen. Ensure single command execution at a time.

Instructions

Execute a bash command. This is stateful (beware with subsequent calls).
Status of the command and the current working directory will always be returned at the end.
The first or the last line might be (...truncated) if the output is too long.
Always run pwd if you get any file or directory not found error to make sure you're not lost.
Run long running commands in background using screen instead of "&".
Do not use 'cat' to read files, use ReadFiles tool instead
In order to check status of previous command, use status_check with empty command argument.
Only command is allowed to run at a time. You need to wait for any previous command to finish before running a new one.
Programs don't hang easily, so most likely explanation for no output is usually that the program is still running, and you need to check status again.
Do not send Ctrl-c before checking for status till 10 minutes or whatever is appropriate for the program to finish.

Input Schema

Name	Required	Description	Default
`action_json`	Yes
`thread_id`	Yes
`wait_for_seconds`	No

Input Schema (JSON Schema)

{
  "$defs": {
    "ActionJsonSchema": {
      "additionalProperties": false,
      "properties": {
        "command": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Set only if type=\"command\""
        },
        "send_ascii": {
          "anyOf": [
            {
              "items": {
                "type": "integer"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Set only if type=\"send_ascii\""
        },
        "send_specials": {
          "anyOf": [
            {
              "items": {
                "enum": [
                  "Enter",
                  "Key-up",
                  "Key-down",
                  "Key-left",
                  "Key-right",
                  "Ctrl-c",
                  "Ctrl-d"
                ],
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Set only if type=\"send_specials\""
        },
        "send_text": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Set only if type=\"send_text\""
        },
        "status_check": {
          "anyOf": [
            {
              "const": true,
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Set only if type=\"status_check\""
        },
        "type": {
          "description": "type of action.",
          "enum": [
            "command",
            "status_check",
            "send_text",
            "send_specials",
            "send_ascii"
          ],
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "action_json": {
      "$ref": "#/$defs/ActionJsonSchema"
    },
    "thread_id": {
      "type": "string"
    },
    "wait_for_seconds": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "action_json",
    "thread_id"
  ],
  "type": "object"
}

mcp-wcgw

BashCommand

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from mcp-wcgw

Related Tools

MCP directory API