muthuishere/mcp-server-bash-sdk

解决的问题

该项目提供了一种轻量级、零开销的方式，使用纯 Bash 构建 Model Context Protocol (MCP) 服务器。它消除了对 Node.js 或 Python 等重型运行时的需求，这些运行时在许多情况下只是进行模式转换的简单 API 包装器。

工作原理

它实现了 2026-07-28 版本的 MCP，该版本是无状态的，因此非常适合使用 shell 读取循环。SDK 由一个核心处理脚本（mcpserver_core.sh）组成，负责处理 JSON-RPC 封装、版本协商和分发。开发者通过源码导入此核心，并在以 tool_ 开头的函数中定义业务逻辑来创建自己的服务器。

支持两种标准传输方式：

• stdio：默认模式，AI 系统将服务器作为子进程启动。
• 可流式 HTTP：使用 socat 或 netcat 的本地端点模式，允许将 POST 请求作为 MCP 消息处理。

适用人群

希望在不引入完整编程语言运行时开销的前提下，构建最小化、快速加载的 MCP 服务器的开发者，尤其适用于本地工具执行或封装现有 shell 命令和 API 的场景。

特色亮点

• 零运行时开销：纯 Bash（3.2+）编写，仅需 jq 进行 JSON 处理。
• 无状态协议：专门针对 2026-07-28 MCP 版本，以实现最大效率。
• 双传输支持：相同的服务器逻辑可同时用于 stdio 和 HTTP 传输。
• 动态工具发现：根据函数命名约定自动分发工具。
• 模式验证：输出根据官方发布的 JSON 模式进行验证。