Skip to content
MCP server

Bash Command MCP

Sophisticated bash command MCP server that runs and manages shell execution.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.0.0
Listing updated
4 days ago

About Bash Command MCP

Bash Command MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add bash-command-mcp -- npx -y bash-command-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "bash-command-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bash-command-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "bash-command-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bash-command-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "bash-command-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "bash-command-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "bash-command-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bash-command-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "bash-command-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bash-command-mcp"
      ]
    }
  }
}

Configuration

  • OTEL_ENABLEDEnable or disable OpenTelemetry instrumentation (`true` or `false`).
  • OTEL_SERVICE_NAMEOpenTelemetry service name override.
  • OTEL_SERVICE_VERSIONOpenTelemetry service version override.
  • OTEL_EXPORTER_OTLP_ENDPOINTOTLP HTTP endpoint for exporting OpenTelemetry traces and metrics (for example `http://localhost:4318`).
  • OTEL_METRIC_EXPORT_INTERVAL_MSOpenTelemetry metrics export interval in milliseconds.
  • BASH_COMMAND_MCP_LOG_DIRDirectory used to store background process stdout/stderr log files.

Pricing

Open source

Bash Command MCP FAQ

Is Bash Command MCP free?

Yes. Bash Command MCP is open source, so you can use and self-host it for free.

How do I add Bash Command MCP to Claude Code?

Run this command in your terminal: claude mcp add bash-command-mcp -- npx -y bash-command-mcp