MCP Server Bash

What is mcp-server-bash?

mcp-server-bash is a minimalistic MCP (Model Context Protocol) server written entirely in shell script. It implements the MCP lifecycle—initialization and operation—and provides a single tool to add two numbers, serving as a reference for learning MCP basics.

How to use mcp-server-bash?

Download the mcp_add.sh script, make it executable (chmod +x mcp_add.sh), then test it from the CLI by piping JSON-RPC messages to the script (e.g., echo '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | bash mcp_add.sh). For use with LLM hosts, add the script’s path to a JSON configuration file under mcpServers.

Key features of mcp-server-bash

• Written entirely in shell script (bash)
• Implements full MCP lifecycle (handshake + operation)
• Provides a single “addition” tool
• Can be tested directly from the command line
• Configurable for Claude Desktop and mcphost
• Minimal codebase for learning MCP internals

Use cases of mcp-server-bash

• Learning how an MCP server works through a minimal example
• Adding two numbers via an LLM host (e.g., Claude Desktop, mcphost)
• Testing MCP protocol messages (tools/list, tools/call) in a shell environment
• Building a foundation for custom MCP servers in shell scripts