bash-command-mcp

A sophisticated Bash MCP server that enables safe, structured shell command execution with first-class background job orchestration. It supports foreground and background process management, including starting, listing, killing, and waiting for background processes. The server provides built-in observability via per-process stdout/stderr log files and OpenTelemetry traces and metrics for production visibility. It allows agent-friendly ergonomics with cwd and env overrides for precise execution context.

Package and access

Local package with source-attributed installation metadata. Koskamo does not execute packages during review.

Community listingLocal stdioSource reviewed; not executedPublished by mrorigo

Vendor documentation

Checks and signals

Each line is separate evidence, not a trust score.

Popularity 2 GitHub stars

What you can do with it

Run shell commands in the foreground with timeout controls
Start and manage background processes with log file tracking
Monitor background process status and retrieve final output
Kill specific background processes by PID

Source and maintenance

Community listingRegistry 1.0.0MIT

mcp-registry: io.github.mrorigo/bash-command-mcp@1.0.0 Source repository

Last repository push: May 21, 2026, 6:50 AM UTC
Maintenance checked: Nov 2, 2026, 3:14 PM UTC

Packages and installation

Source-provided package data. Koskamo has not executed or live-probed this package.

bash-command-mcp 0.1.0

npm

bash-command-mcp package definition

{
  "version": "0.1.0",
  "transport": "stdio",
  "identifier": "bash-command-mcp",
  "registryType": "npm",
  "environmentVariables": [
    {
      "name": "OTEL_ENABLED",
      "format": "string",
      "description": "Enable or disable OpenTelemetry instrumentation (`true` or `false`)."
    },
    {
      "name": "OTEL_SERVICE_NAME",
      "format": "string",
      "description": "OpenTelemetry service name override."
    },
    {
      "name": "OTEL_SERVICE_VERSION",
      "format": "string",
      "description": "OpenTelemetry service version override."
    },
    {
      "name": "OTEL_EXPORTER_OTLP_ENDPOINT",
      "format": "string",
      "description": "OTLP HTTP endpoint for exporting OpenTelemetry traces and metrics (for example `http://localhost:4318`)."
    },
    {
      "name": "OTEL_METRIC_EXPORT_INTERVAL_MS",
      "format": "string",
      "description": "OpenTelemetry metrics export interval in milliseconds."
    },
    {
      "name": "BASH_COMMAND_MCP_LOG_DIR",
      "format": "string",
      "description": "Directory used to store background process stdout/stderr log files."
    }
  ]
}

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 2, 2026, 3:15 PM UTC · repository · passed · metadata changed · updated
Nov 2, 2026, 3:14 PM UTC · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown

Connect from your client

Each snippet configures the same source-provided package; replace placeholders before use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Cursor

Merge this local stdio configuration, replace every placeholder environment value, and restart Cursor. Koskamo has not executed this package.

Cursor configuration

{
  "mcpServers": {
    "bash-command-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bash-command-mcp@0.1.0"
      ],
      "env": {
        "OTEL_ENABLED": "<YOUR_OTEL_ENABLED>",
        "OTEL_SERVICE_NAME": "<YOUR_OTEL_SERVICE_NAME>",
        "OTEL_SERVICE_VERSION": "<YOUR_OTEL_SERVICE_VERSION>",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "<YOUR_OTEL_EXPORTER_OTLP_ENDPOINT>",
        "OTEL_METRIC_EXPORT_INTERVAL_MS": "<YOUR_OTEL_METRIC_EXPORT_INTERVAL_MS>",
        "BASH_COMMAND_MCP_LOG_DIR": "<YOUR_BASH_COMMAND_MCP_LOG_DIR>"
      }
    }
  }
}

Cline

Merge this local stdio configuration, replace every placeholder environment value, and restart Cline. Koskamo has not executed this package.

Cline configuration

{
  "mcpServers": {
    "bash-command-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bash-command-mcp@0.1.0"
      ],
      "env": {
        "OTEL_ENABLED": "<YOUR_OTEL_ENABLED>",
        "OTEL_SERVICE_NAME": "<YOUR_OTEL_SERVICE_NAME>",
        "OTEL_SERVICE_VERSION": "<YOUR_OTEL_SERVICE_VERSION>",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "<YOUR_OTEL_EXPORTER_OTLP_ENDPOINT>",
        "OTEL_METRIC_EXPORT_INTERVAL_MS": "<YOUR_OTEL_METRIC_EXPORT_INTERVAL_MS>",
        "BASH_COMMAND_MCP_LOG_DIR": "<YOUR_BASH_COMMAND_MCP_LOG_DIR>"
      }
    }
  }
}

VS Code

Merge this local stdio configuration, replace every placeholder environment value, and restart VS Code. Koskamo has not executed this package.

VS Code configuration

{
  "servers": {
    "bash-command-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "bash-command-mcp@0.1.0"
      ],
      "env": {
        "OTEL_ENABLED": "<YOUR_OTEL_ENABLED>",
        "OTEL_SERVICE_NAME": "<YOUR_OTEL_SERVICE_NAME>",
        "OTEL_SERVICE_VERSION": "<YOUR_OTEL_SERVICE_VERSION>",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "<YOUR_OTEL_EXPORTER_OTLP_ENDPOINT>",
        "OTEL_METRIC_EXPORT_INTERVAL_MS": "<YOUR_OTEL_METRIC_EXPORT_INTERVAL_MS>",
        "BASH_COMMAND_MCP_LOG_DIR": "<YOUR_BASH_COMMAND_MCP_LOG_DIR>"
      }
    }
  }
}

Claude Desktop

Merge this local stdio configuration, replace every placeholder environment value, and restart Claude Desktop. Koskamo has not executed this package.

Claude Desktop configuration

{
  "mcpServers": {
    "bash-command-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bash-command-mcp@0.1.0"
      ],
      "env": {
        "OTEL_ENABLED": "<YOUR_OTEL_ENABLED>",
        "OTEL_SERVICE_NAME": "<YOUR_OTEL_SERVICE_NAME>",
        "OTEL_SERVICE_VERSION": "<YOUR_OTEL_SERVICE_VERSION>",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "<YOUR_OTEL_EXPORTER_OTLP_ENDPOINT>",
        "OTEL_METRIC_EXPORT_INTERVAL_MS": "<YOUR_OTEL_METRIC_EXPORT_INTERVAL_MS>",
        "BASH_COMMAND_MCP_LOG_DIR": "<YOUR_BASH_COMMAND_MCP_LOG_DIR>"
      }
    }
  }
}

Let your agent find its tools

Find servers like bash-command-mcp from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 7,692