Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add reason-machines/mcp-skills --skill mcp-server-bash-sdk -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/mcp-server-bash-sdk/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/mcp-server-bash-sdk/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set98

The whole set →
mcp-server-spec-driven-development The mcp-server-spec-driven-development skill guides a project from EARS requirements to a design document and generated code. Use it when you want those steps to build on one another. CX Codex +1 175installs mcp-code-execution-mode mcp-code-execution-mode executes Python inside rootless containers and routes calls to MCP servers to keep token consumption minimal. CX Codex +1 174installs mcp-server-code-execution-mode mcp-server-code-execution-mode executes Python in rootless Podman or Docker containers and proxies MCP tools through a single entry point, cutting context from 30,000 to 200 tokens. CX Codex +1 173installs nanobanana-mcp-image-generation The nanobanana-mcp-image-generation skill connects an agent to Gemini image generation and editing with model selection, 4K output, aspect ratios, and templates. Use it for visual assets from a coding workspace. CX Codex +1 172installs codex-mcp-server-integration codex-mcp-server-integration — a skill that bridges OpenAI Codex CLI to Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode via MCP. Brings code analysis, generation, branch review, and web search into the editor. CX Codex +1 171installs remote-mcp-server-with-auth remote-mcp-server-with-auth is a Claude Code skill for building and deploying a Cloudflare Workers MCP server with GitHub OAuth and PostgreSQL. It supports role-based permissions. CX Codex +1 168installs postman-mcp-server Hooks your coding agent up to Postman over MCP: workspaces, collections, environments, request runs and client code generation. CX Codex +1 168installs mcp-server-12306 Enables AI agents to query China Railway 12306 services. Checks real-time train availability, seat prices, schedules, and transfer routes. CX Codex +1 167installs

Project sponsors

Companies that keep this analytics open