# mcp-server-bash-sdk

mcp-server-bash-sdk guides you in building zero-runtime Model Context Protocol servers using pure Bash and jq instead of heavy runtimes.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 171 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/mcp-server-bash-sdk/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/mcp-server-bash-sdk

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcp-server-bash-sdk -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/mcp-server-bash-sdk/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/mcp-server-bash-sdk/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcp-server-bash-sdk -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/mcp-server-bash-sdk/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcp-server-bash-sdk -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/mcp-server-bash-sdk/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/mcp-server-bash-sdk
```

2. **Manually: put the files in place**
- File: `.github/skills/mcp-server-bash-sdk/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcp-server-bash-sdk -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/mcp-server-bash-sdk
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/mcp-server-bash-sdk/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcp-server-bash-sdk -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/mcp-server-bash-sdk/SKILL.md

## When to use it
- 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
- 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

## Similar
- [bash-linux](https://affpapa.org/en/nevibecode/skills/bash-linux.md) — skill · 215 installs
- [bash-scripting](https://affpapa.org/en/nevibecode/skills/sickn33-bash-scripting.md) — skill · 2500 installs
- [bash-script-validator](https://affpapa.org/en/nevibecode/skills/bash-script-validator.md) — skill · 775 installs
- [bash-script-generator](https://affpapa.org/en/nevibecode/skills/bash-script-generator.md) — skill · 742 installs
- [bash-master](https://affpapa.org/en/nevibecode/skills/bash-master.md) — skill · 464 installs
- [bash-pro](https://affpapa.org/en/nevibecode/skills/rmyndharis-bash-pro.md) — skill · 123 installs

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
