# bash MCP server

> Allows an AI assistant to execute bash commands on a local machine via a secure WebSocket connector.

- Repository: https://github.com/assistant-core/mcp-bash
- Page: https://hostedmcp.org/servers/assistant-core/mcp-bash
- Transport: —
- Stars: 0
- License: MIT

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `BASH_TOOL_NAME` | no | no |  |
| `LOCAL_CONNECTOR_TOKEN` | no | no |  |
| `LOCAL_CONNECTOR_URL` | no | no |  |

## Tools (3)

- `command`
- `timeout_seconds`
- `restart`

## FAQ

### How do I run bash commands through this server?

The server provides a `bash` tool that accepts a command string, an optional timeout, and a restart flag to determine the working directory.

### Can I restrict which commands the assistant is allowed to run?

Yes, the Assistant Core admin can set rules to Allow, Ask, or Block specific commands, with Block taking precedence.

### How does the connector handle network connectivity?

The connector dials out over WebSocket, meaning the machine does not require a public URL or open ports, and it uses exponential backoff for reconnections.
