loading…
Search for a command to run...
loading…
An MCP server that enables the execution of arbitrary bash commands and returns detailed output including stdout, stderr, and exit codes. It supports customizab
An MCP server that enables the execution of arbitrary bash commands and returns detailed output including stdout, stderr, and exit codes. It supports customizable working directories, execution timeouts, and environment variable configurations.
mpak NimbleBrain Discord License: MIT
A Model Context Protocol (MCP) server that executes bash commands. Returns stdout, stderr, exit code, and execution duration for each command.
View on mpak registry | Built by NimbleBrain
Install with mpak:
mpak install @nimblebraininc/bash
claude mcp add bash -- mpak run @nimblebraininc/bash
Add to your claude_desktop_config.json:
{
"mcpServers": {
"bash": {
"command": "mpak",
"args": ["run", "@nimblebraininc/bash"]
}
}
}
See the mpak registry page for full install options.
Execute a bash command and return stdout, stderr, exit code, and duration.
| Parameter | Type | Required | Description |
|---|---|---|---|
command |
string |
Yes | The bash command to execute |
cwd |
string |
No | Working directory (defaults to server's cwd) |
timeout |
integer |
No | Timeout in seconds (default: 30, max: 600) |
env |
object |
No | Additional environment variables to set |
Example call:
{
"name": "bash_exec",
"arguments": {
"command": "ls -la /tmp",
"timeout": 10
}
}
Example response:
{
"stdout": "total 0\ndrwxrwxrwt 12 root wheel 384 Jan 15 12:00 .\ndrwxr-xr-x 6 root wheel 192 Jan 1 00:00 ..\n",
"stderr": "",
"exit_code": 0,
"duration_ms": 12
}
This server executes arbitrary bash commands. Security is secure-by-deployment: the server itself has no allowlist or sandbox. Instead, security is enforced by the deployment environment:
subprocess: "full") at install timeThe MTF permission declaration (subprocess: "full", filesystem: "full", network: "full") accurately reflects that bash commands can read/write files and make network calls.
git clone https://github.com/NimbleBrainInc/mcp-bash.git
cd mcp-bash
# Install dependencies
uv sync
# Run the server (stdio mode)
uv run python -m mcp_bash.server
# Or run via FastMCP
uv run fastmcp run src/mcp_bash/server.py
The server supports HTTP transport with:
GET /healthPOST /mcp# Install with dev dependencies
uv sync --group dev
# Run unit tests
make test
# Run with coverage
make test-cov
# Run all checks (format, lint, typecheck, unit tests)
make check
# Format
uv run ruff format .
# Lint
uv run ruff check .
End-to-end tests validate the full MCPB bundle lifecycle: building the bundle, deploying it into a Docker container, and calling tools over HTTP.
Prerequisites: Docker running, mcpb CLI installed (npm install -g @anthropic-ai/mcpb)
make test-e2e
The tests:
.mcpb bundle with mcpb packnimbletools/mcpb-python container that downloads and runs the bundle/health endpoint, MCP tool listing, and tool invocation via streamable HTTPBash MCP Server is published on the mpak registry and built by NimbleBrain. mpak is an open registry for Model Context Protocol servers.
MIT
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"bash-mcp-server": {
"command": "npx",
"args": []
}
}
}