Capsule Bash MCP

AI 에이전트가 안전하고 지속적인 샌드박스 환경에서 bash 명령을 실행할 수 있도록 하는 MCP 서버입니다.

작동 방식

각 세션은 WebAssembly 샌드박스 내부에서 실행됩니다. 샌드박스는 다음을 제공합니다:

• 지속적인 상태: 세션 내의 명령 간에 cwd, 환경 변수 및 파일 시스템 변경 사항이 유지됩니다.

• 파일 시스템 차이(diff): 모든 run 응답에는 디스크에서 변경된 내용의 차이가 포함됩니다.

• 격리된 메모리: 각 세션은 고유한 주소 공간을 가지며 세션 간 데이터 유출이 없습니다.

• 호스트 접근 불가: 샌드박스는 호스트 파일 시스템이나 네트워크에 접근할 수 없습니다.

Capsule Bash에 대해 더 알아보세요.

도구

세션

동일한 session_id 내의 명령은 호출 간에 cwd, 환경 변수 및 파일 시스템 상태를 공유합니다.

예시

AI 에이전트에게 다음과 같이 요청하세요:

"숫자 목록의 평균을 구하는 Python 스크립트를 작성해 줘."

에이전트는 순차적으로 run을 호출합니다:

{ "command": "mkdir -p /data && cd /data", "session_id": "custom_session" }
{ "command": "echo 'nums = [x for x in [1, 2, 3, []] if isinstance(x, int)]\nprint(sum(nums) / len(nums))' > avg.py", "session_id": "custom_session" }
{ "command": "python3 avg.py", "session_id": "custom_session" }

각 호출은 stdout, stderr, exitCode, 파일 시스템 diff 및 업데이트된 state를 반환하여 컨텍스트를 풍부하게 하고 대화 기록을 추적합니다.

설정

MCP 클라이언트 구성(예: Claude Desktop, Cursor)에 추가하세요:

{
  "mcpServers": {
    "bash": {
      "command": "npx",
      "args": ["-y", "@capsule-run/bash-mcp"]
    }
  }
}

제한 사항

• 모든 bash 명령 및 옵션이 구현된 것은 아닙니다. 명령이 누락되었거나 예상치 않게 작동하는 경우 이슈를 열어 알려주세요.