muthuishere/mcp-server-bash-sdk

해결하는 문제

이 프로젝트는 순수한 Bash를 사용하여 가볍고 오버헤드가 없는 Model Context Protocol (MCP) 서버를 구축하는 방법을 제공합니다. 일반적으로 스키마 변환만 하는 API 래퍼인 간단한 MCP 서버에 Node.js나 Python과 같은 무거운 런타임이 필요하지 않습니다.

작동 방식

이 SDK는 상태 없음(stateless)인 2026-07-28 리비전의 MCP를 구현하며, 쉘 리드 루프에 자연스럽게 어울립니다. SDK는 JSON-RPC 프레임워크, 버전 협상, 디스패치를 처리하는 핵심 스크립트(mcpserver_core.sh)로 구성되어 있습니다. 개발자는 이 핵심 스크립트를 소스로 불러와 tool_으로 시작하는 함수에 비즈니스 로직을 정의함으로써 자신만의 서버를 만들 수 있습니다.

두 가지 표준 전송 방식을 지원합니다:

• stdio: AI 시스템이 서버를 하위 프로세스로 실행하는 기본 모드.
• Streamable HTTP: socat 또는 netcat를 사용하는 로컬 엔드포인트 모드로, POST 요청을 MCP 메시지로 처리할 수 있습니다.

대상 사용자

풀 프로그래밍 언어 런타임의 오버헤드 없이 최소한의 서버를 빠르게 로드하고 싶은 개발자들. 특히 로컬 도구 실행이나 기존 쉘 명령어 및 API를 래핑할 때 적합합니다.

주요 특징

• 런타임 오버헤드 없음: 순수한 Bash(3.2+)로 구현되었으며, JSON 처리에는 jq만 필요합니다.
• 상태 없음 프로토콜: 최대 효율성을 위해 2026-07-28 MCP 리비전에 특화되어 있습니다.
• 이중 전송 방식 지원: 동일한 서버 로직이 stdio와 HTTP 양쪽 모두에서 작동합니다.
• 동적 도구 탐지: 함수 이름 규칙에 따라 도구가 자동으로 디스패치됩니다.
• 스키마 검증 완료: 출력은 공식적으로 발표된 JSON 스키마에 따라 검증됩니다.