mcp-server-bash

by antonum

30 stars
212 downloads
Not rated
GitHub

About

minimalistic MCP server written in bash script

Details

Author
antonum
GitHub stars
30
Downloads
212
Categories
Developer Tools

- 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.

Phases of MCP

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.