Back to Home
yaniv-golan icon

mcp-bash-framework

Verified Safe

by yaniv-golan

Overview

A Bash-based framework for building and running Micro-service Context Protocol (MCP) servers, enabling the creation of custom AI-integrable tools, resources, prompts, and completions.

Installation

Run Command
mcp-bash

Environment Variables

  • MCPBASH_PROJECT_ROOT
  • MCPBASH_REMOTE_TOKEN
  • MCPBASH_TOOL_ALLOWLIST
  • MCPBASH_TOOL_ENV_MODE
  • MCP_REGISTRY_TOKEN

Security Notes

The framework demonstrates a high commitment to security, especially for a Bash environment. It features robust environment isolation for subprocesses (tools, providers) to prevent information leakage and privilege escalation. Extensive path validation and root containment checks guard against path traversal. Project-level shell scripts (hooks) are subject to strict ownership and permission checks, mitigating local privilege escalation risks. Input is sanitized, heavily relying on 'jq'/'gojq' for JSON processing to reduce shell injection risks. Remote authentication with constant-time token comparison helps secure proxied deployments. Network policy functions aid in preventing Server-Side Request Forgery (SSRF). 'eval' is explicitly avoided in critical path operations.

Similar Servers

Stats

Interest Score33
Security Score9
Cost ClassMedium
Avg Tokens2000
Stars3
Forks1
Last Update2026-01-19

Tags

BashServer FrameworkMicroserviceCLIDeveloper ToolsAI IntegrationCode Generation