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 模式進行驗證。