mcp-server-bash
About
minimalistic MCP server written in bash script
Details
- Author
- antonum
- GitHub stars
- 30
- Downloads
- 212
- Categories
- Developer Tools
Jump to
- 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
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.
mcp-server-bash
Minimalistic MCP server written in shell script.
This repo is comlimentary to the article: Minimalistic MCP Server in bash script
The lifecycle of MCP server can be described in two phases. Initialization and Operation.

The mcp_add.sh implements all of the messages within this lifecicle, from the handshake to execution of the simple "add two numbers" tool.
To do the basic test methods right in CLI use:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





