MCP Server Bash SDK CLI
mcp-server-bash-sdk
An SDK for an MCP server entirely in Bash for protocol version 2026-07-28: jq is needed. A base for your own server and not a ready server
- 515 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- A base: access depends on your tools
- The tools run shell commands
Install
- Works in
Manual install
git clone https://github.com/muthuishere/mcp-server-bash-sdkjq is needed (brew install jq or apt install jq). socat is recommended for the connection mode.
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- A base: access depends on your tools
- The tools run shell commands
This is third-party code. Review the repository files before installing.
What it does
MCP Server Bash SDK lets you write an MCP server entirely in Bash. Protocol version 2026-07-28, `jq` is needed (`brew install jq` or `apt install jq`). Installation by cloning: `git clone https://github.com/muthuishere/mcp-server-bash-sdk`. Streaming (SSE) is not supported. `socat` is recommended for the connection mode. Version 0.4.1 from 04.08.2026, MIT license. It is a base on which you write your own tools and not a ready server.
Who it is for. For developers who need a very small MCP server on shell scripts without a runtime such as Node or Python.
Good fit when
- You need an MCP server on Bash without Node and Python
- You need to quickly wrap shell commands in MCP tools
- You need a minimal MCP protocol example
Not a fit when
- You need a ready server: this is a base
- You need SSE streaming: it is absent
Example request
Write an MCP tool in Bash that returns free disk space and connect it to the agentLimitations
This is a base: access depends on the tools you add to it, and they run shell commands. Validate input to prevent command substitution. There is no SSE streaming. The author lists paid consultations, which are not part of the project.
How to disable. Delete the repository clone and the server entries from the client.
FAQ
What is it?
An SDK for writing an MCP server entirely in Bash.
What is needed?
jq, and socat is recommended for the connection mode.
Is it a ready server?
No, it is a base for your own tools.
Discussion
No questions or reviews yet.
Related
CLI toolsA lightweight CLI to discover, inspect and call MCP server tools straight from the shell
An MCP server that lets an agent read files, search code and run commands in a workspace
A plugin with skills for building TypeScript MCP servers and MCP apps: the agent scaffolds, edits, debugs and verifies them
A local tool to test and debug MCP servers: chat with tools, inspect calls and run evals across clients
A CLI and TypeScript runtime for calling MCP servers from a terminal, scripts and generated typed clients
Awesome Remote MCP Servers (jaw9c)
awesome-remote-mcp-servers-jaw9c
A curated list of remote MCP servers: official and maintained servers you connect to over the network. It is a list of links with no code of its own
README in short
The README describes an SDK for an MCP server on Bash for protocol version 2026-07-28 with installation by cloning. MIT license.