mcp-server-bash-sdk

Source the mcpserver_core.sh protocol layer, define functions prefixed with tool_ that accept JSON arguments as $1, and declare tool schemas in a tools JSON file. Call run_mcp_server at the end to start JSON-RPC communication over stdio.

You need Bash 4.0 or later and jq for JSON processing. No Node.js, Python, or other runtimes are required since the SDK handles the MCP protocol layer in pure shell script.

Yes, register the server script path in claude_desktop_config.json under mcpServers with the command pointing to your executable Bash script. Environment variables like API keys can be passed through the env object.

The function name must exactly match the tool name in tools_list.json with the tool_ prefix, and the function must be defined before run_mcp_server is called. Validate the JSON file with jq and test discovery using the tools/list method.

Validate input with jq before processing and use jq -n --arg to construct JSON output instead of string interpolation, which avoids shell expansion issues. Enable logging via MCP_LOG_FILE and write debug output to stderr.