#138 · Primary category: LLM Application Frameworks

mcp-server-bash-sdk

ai-agents bash mcp model-context-protocol sdk

MCP server SDK/example implemented entirely in bash — build a Model Context Protocol server with no runtime dependency beyond a POSIX shell.

Project last updated:08/05/26

GitHub Stars

515

Forks

49

Contributors

3

License

MIT

Why we included this project

Some environments won't let a Node.js or Python runtime in the door, and for those this MCP server written entirely in bash is a good fit: its only dependency is a POSIX shell, so it works in a tiny container, an Alpine edge device, or a locked-down CI runner. The same core code handles both stdio and Streamable HTTP against the 2026-07-28 stateless revision of the protocol, so the two transports stay in sync. Defining a tool is just writing a function named tool_* in the script, which makes it approachable for teams who already live in bash, and the repo includes unit tests, HTTP-transport tests, and a conformance test against the official schema, plus a walkthrough for building your own. The appeal is a server you can read through line by line and patch with confidence when a full runtime feels like overkill.

Articles for this project

No articles for this project yet.

To suggest a topic or contribute an article, contact us.

Related projects in this category