Portable Bash-only framework for building stdio Model Context Protocol (MCP) servers with zero dependencies.
概览
mcp-bash-framework • mcp-bash Read llms.txt (compact) or llms-full.txt (detailed) for agent-optimized context — includes a step-by-step Quick Start, critical allowlist requirement, and CLI wrapper patterns. /plugin install mcp-bash --marketplace yaniv-golan/mcp-bash-framework installs a skill with the workflow and common traps for building mcp-bash servers. On older Claude Code: /plugin marketplace add yaniv-golan/mcp-bash-framework, then /plugin install mcp-bash@mcp-bash. Tools, resources, prompts, elicitation, roots, progress, cancellation—the full spec, no runtimes beyond your shell. - Runs on Bash 3.2+ (macOS/Linux stock). No Node, no Python, no containers. - Handles concurrency, timeouts, and cancellation the way production systems need. - You write the tools. The framework stays out of your way. - Tools shouldn’t need another runtime to talk to AI. - Everything must be inspectable. No magic. - If it’s not needed in production, it isn’t in the framework.
README
以下为原文 README 节选，完整内容请查看原文。
mcp-bash
Repository:
mcp-bash-framework• CLI/Binary:mcp-bash
For AI agents: Read
llms.txt(compact) orllms-full.txt(detailed) for agent-optimized context — includes a step-by-step Quick Start, critical allowlist requirement, and CLI wrapper patterns.Claude Code skill:
/plugin install mcp-bash --marketplace yaniv-golan/mcp-bash-frameworkinstalls a skill with the workflow and common traps for building mcp-bash servers. On older Claude Code:/plugin marketplace add yaniv-golan/mcp-bash-framework, then/plugin install mcp-bash@mcp-bash.
Contents
- TL;DR
- What you’ll build
- Design Principles
- MCP Spec Coverage
- Why Bash?
- Quick Start
- Security Model (60 seconds)
- Configure Your MCP Client
- MCPB Bundles
- Vendoring the Runtime
- Project Structure
- Direct Tool Execution (run-tool)
- Embedded resources in tool output
- Diagnostics & Validation
- SDK Discovery
- Roots (scoping filesystem access)
- Completions
- Tool Policy Hook (optional)
- Learn by Example
- Features at a Glance
- Configuration
- Troubleshooting (quick hits)
- Requirements
- Uninstall
- Documentation
- Built with mcp-bash
- FAQ
The most complete MCP implementation in pure Bash. Tools, resources, prompts, elicitation, roots, progress, cancellation—the full spec, no runtimes beyond your shell.
- Runs on Bash 3.2+ (macOS/Linux stock). No Node, no Python, no containers.
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
"mcpServers": {
"mcp-bash": {
"command": "/Users/you/.local/bin/mcp-bash",
"env": {
"MCPBASH_PROJECT_ROOT": "/Users/you/my-mcp-server",
"MCPBASH_TOOL_ALLOWLIST": "*"
}
}
}