muthuishere/mcp-server-bash-sdk

何を解決するか

このプロジェクトは、純粋な Bash を使用して、軽量でオーバーヘッドのない Model Context Protocol (MCP) サーバーを構築する方法を提供します。Node.js や Python などの重いランタイムを必要とせず、多くの場合、スキーマ変換を行うだけの API ラッパーとして機能する単純な MCP サーバーに最適です。

動作方法

この SDK は、2026-07-28 リビジョンの MCP を実装しており、状態なし（stateless）であるため、シェルのリードループに自然に適合します。SDK は、JSON-RPC フレーミング、バージョンネゴシエーション、ディスパッチを処理するコアスクリプト（mcpserver_core.sh）で構成されています。開発者はこのコアを読み込み、tool_ で始まる関数にビジネスロジックを定義することで独自のサーバーを作成できます。

標準的な2つのトランスポートをサポートしています：

• stdio：AI システムがサーバーをサブプロセスとして起動するデフォルトモード。
• Streamable HTTP：socat や netcat を使用するローカルエンドポイントモードで、POST リクエストを MCP メッセージとして処理できます。

対象ユーザー

フルプログラミング言語ランタイムのオーバーヘッドなしに、最小限で高速にロードされる MCP サーバーを構築したい開発者。特にローカルツール実行や既存のシェルコマンド・API のラッピングに適しています。

特徴

• ランタイムオーバーヘッドゼロ：純粋な Bash（3.2+）で構築。JSON 処理には jq のみが必要。
• 状態なしプロトコル：最大の効率性を実現するため、2026-07-28 MCP リビジョンに特化。
• 二重トランスポート対応：同じサーバーロジックが stdio と HTTP 両方で動作可能。
• 動的ツール発見：関数名の命名規則に基づいてツールが自動的にディスパッチ。
• スキーマ検証済み：出力は公式に公開された JSON スキーマに基づいて検証されます。