mcp-server-bash-sdk — Claude Code skill: what it does, how to install
mcp-server-bash-sdk guides you in building zero-runtime Model Context Protocol servers using pure Bash and jq instead of heavy runtimes.
no license 171 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill mcp-server-bash-sdk -a claude-codeWhat mcp-server-bash-sdk does
The skill provides guidelines and structure for creating lightweight MCP servers. Protocol handling for JSON-RPC 2.0 over standard input and output is managed by mcpserver_core.sh. You write shell scripts with dedicated functions matching the tool_* prefix and map them to schema definitions stored inside JSON files under assets/.
Every tool function reads its JSON payload from argument $1, echoes output, and signals status with return code 0 or 1. Data parsing and output formatting rely entirely on the jq utility, keeping memory usage minimal.
Without Bash 4.0+ and jq installed on the host system, the underlying core script cannot parse JSON-RPC payloads.
What it helps with
- build MCP servers in shell scripts without Node.js or Python
- wrap terminal utilities and curl endpoints into MCP tools
- structure JSON parameter schemas for shell-based tool calls
- test JSON-RPC stdio handshakes directly via command line pipes
Example prompts for the agent
- Create an MCP server in bash to check server memory stats
- Write a tool function in shell script for fetching API metrics
- Help me debug an MCP tools/call request piped into my bash script
How to install mcp-server-bash-sdk
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcp-server-bash-sdk -a claude-code2Manually: put the files in place
~/.claude/skills/mcp-server-bash-sdk/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mcp-server-bash-sdk/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcp-server-bash-sdk -a codex2Manually: put the files in place
.agents/skills/mcp-server-bash-sdk/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcp-server-bash-sdk -a cursor2Manually: put the files in place
.cursor/skills/mcp-server-bash-sdk/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/mcp-server-bash-sdk2Manually: put the files in place
.github/skills/mcp-server-bash-sdk/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcp-server-bash-sdk -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/mcp-server-bash-sdkManually: put the files in place
.devin/skills/mcp-server-bash-sdk/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcp-server-bash-sdk -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about mcp-server-bash-sdk
How to install mcp-server-bash-sdk in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill mcp-server-bash-sdk -a claude-code in your terminal. This creates ~/.claude/skills/mcp-server-bash-sdk/SKILL.md.
What does mcp-server-bash-sdk do?
It provides your AI assistant with the blueprint and contract rules needed to scaffold pure Bash MCP servers.
What prerequisites are needed to run these servers?
You need Bash shell version 4.0 or higher alongside the jq command-line JSON processor.