Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCPBASH_ROOTS | No | Manual override for filesystem roots as a colon-separated list (e.g., '/path/one:/path/two'). | |
| MCPBASH_LOG_LEVEL | No | Log level for the server; use 'debug' for discovery traces. | info |
| MSYS2_ARG_CONV_EXCL | No | Recommended for Windows Git Bash to prevent path conversion quirks (usually set to '*'). | |
| MCPBASH_DEBUG_ERRORS | No | Includes tool diagnostics (exit code, stderr tail) in outputSchema validation errors. | false |
| MCPBASH_PROJECT_ROOT | Yes | Path to your project directory containing tools/, prompts/, and resources/. Required for MCP clients so the server can find your project regardless of working directory. | |
| MCPBASH_REMOTE_TOKEN | No | Shared secret for proxied deployments (minimum 32 characters). | |
| MCPBASH_TOOL_ENV_MODE | No | Controls environment isolation for tool processes: 'minimal', 'inherit', or 'allowlist'. | minimal |
| MCPBASH_TOOL_ALLOWLIST | No | Explicit allowlist for tools (e.g., set to '*' to allow all in trusted projects). Tools are blocked by default policy. | |
| MCPBASH_HTTPS_ALLOW_ALL | No | Explicitly allow all public HTTPS hosts (unsafe; prefer MCPBASH_HTTPS_ALLOW_HOSTS). | false |
| MCPBASH_HTTPS_ALLOW_HOSTS | No | Comma-separated allowlist for HTTPS provider hosts. | |
| MCPBASH_ALLOW_PROJECT_HOOKS | No | Enables project hooks (like server.d/policy.sh). Hooks are disabled by default for security. | false |
| MCPBASH_DEFAULT_TOOL_TIMEOUT | No | Default timeout for tool execution in seconds. | 30 |
| MCPBASH_ENABLE_LIVE_PROGRESS | No | Enables streaming of progress and log notifications during tool execution. | false |
| MCPBASH_TOOL_ENV_INHERIT_ALLOW | No | Must be set to 'true' to allow MCPBASH_TOOL_ENV_MODE=inherit. | false |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |