mcp-server-bash
About
minimalistic MCP server written in bash script
Details
- License
- MIT
Explore
- 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
JSON Configuration file for mcphost and Claude Desktop:
{
"mcpServers": {
"math": {
"command": "/Users/anton/code/mcp-server-bash/mcp_add.sh",
"args": []
}
}
}
echo '{"method":"tools/list","params":{},"jsonrpc":"2.0","id":2}' | bash mcp_add.sh | jq
echo '{"jsonrpc":"2.0","id":20, "method":"tools/call","params":{"name":"addition","arguments":{"num1":"1","num2":"2"}}}' | bash mcp_add.sh | jq
```
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.
