표준 입출력 (Standard Input/Output, stdio)

표준 입출력(Standard Input/Output, stdio)은 프로그램이 입력을 읽고 결과와 진단 메시지를 내보내는 기본 스트림 체계입니다. 표준 입력 stdin, 표준 출력 stdout, 표준 오류 stderr를 구별합니다. 터미널과 연결해 사람이 사용하거나 파일과 파이프로 연결해 다른 프로그램과 데이터를 주고받는 데 사용합니다.

입력과 두 출력의 역할

표준 입력은 프로그램이 데이터를 읽는 통로이고 표준 출력은 처리 결과를 내보내는 통로입니다. 표준 오류는 오류와 진단 메시지를 내보내는 별도 통로입니다. Python의 표준 스트림 문서는 sys.stdin, sys.stdout, sys.stderr를 이 역할에 대응하는 파일 객체로 설명합니다. 이름에 오류가 들어가도 그 스트림의 출력만으로 프로그램의 종료 상태를 판정하는 것은 별개의 문제입니다.

터미널에서 직접 실행하면 입력은 키보드, 출력은 화면으로 연결된 경우가 많습니다. 파일로 입력을 바꾸거나 출력을 파일에 저장하면 연결 대상이 달라집니다. 프로그램은 같은 표준 스트림을 사용하면서도 실제 데이터를 받거나 보내는 대상이 바뀔 수 있습니다. 화면에서 글자가 보이지 않는다는 이유만으로 출력이 없었다고 판단하기보다 실행할 때 어디에 연결했는지 확인합니다.

표준 출력과 표준 오류가 같은 화면에 표시되더라도 논리적으로는 다른 스트림입니다. 결과를 JSON으로 내보내는 명령이 진행 상황을 표준 오류로 보내면 다음 프로그램은 결과만 읽을 수 있습니다. 반대로 진행 문장을 표준 출력에 섞으면 JSON 파서가 그 문장을 데이터로 읽다가 실패할 수 있습니다. 사람에게 보여 줄 설명과 기계가 받을 결과를 어느 통로로 보낼지 정하는 것이 인터페이스의 일부입니다.

파이프와 프로세스 사이의 연결

파이프는 한 프로그램의 출력을 다른 프로그램의 입력으로 이어 줍니다. 파일 목록을 출력하는 프로그램과 그 목록에서 조건에 맞는 줄을 고르는 프로그램을 연결하는 작업이 한 예입니다. 앞 프로그램이 보내는 형식과 뒤 프로그램이 기대하는 형식이 맞아야 올바르게 처리됩니다. 단순히 두 명령이 실행됐다는 사실만으로 전달된 데이터의 의미까지 맞았다고 판단하지 않습니다.

텍스트를 주고받을 때는 문자 인코딩과 줄 구분도 계약에 포함됩니다. 같은 바이트를 서로 다른 인코딩으로 해석하면 한글이나 특수 문자가 깨질 수 있습니다. Python의 표준 스트림 설명은 실행 환경에 따른 인코딩과 버퍼링 차이를 다룹니다. 결과가 바로 보이지 않는 경우에는 프로그램이 아직 계산 중인지, 출력이 버퍼에 남아 있는지 구별할 필요가 있습니다.

입력의 끝도 데이터 내용과 별개입니다. 입력 스트림이 닫히면 받는 프로그램은 더 읽을 값이 없다는 사실을 알 수 있습니다. 계속 입력을 기다리는 프로그램에 출력만 보냈다고 작업이 끝나는 것은 아닙니다. 자동화에서는 입력을 언제 닫고 프로세스 종료를 언제 기다릴지 함께 정하면 서로 상대의 다음 동작을 기다리는 상황을 줄일 수 있습니다.

MCP 전송 방식에서의 조건

MCP 2025-06-18 전송 명세는 stdio 방식에서 클라이언트가 서버를 자식 프로세스로 실행하고 표준 입력과 표준 출력으로 JSON-RPC 메시지를 주고받도록 정합니다. 메시지는 UTF-8로 인코딩하고 줄바꿈으로 구분합니다. 이 설명은 명시한 명세 버전의 전송 규칙이며, 모든 표준 입출력 프로그램이 JSON-RPC를 사용한다는 뜻은 아닙니다.

같은 명세는 서버가 로그를 표준 오류에 쓸 수 있지만 표준 출력에는 유효한 MCP 메시지 이외의 내용을 쓰지 못하도록 정합니다. 시작 안내나 디버그 문장 하나가 메시지 통로에 섞여도 클라이언트의 해석을 방해할 수 있습니다. 서버가 실행되는데 연결이 실패한다면 프로세스 실행 오류와 프로토콜 출력 혼입을 나누어 살피는 것이 진단에 도움이 됩니다.

MCP의 다른 전송 방식인 Streamable HTTP는 HTTP 연결을 사용합니다. stdio는 클라이언트가 실행한 프로세스의 스트림을 연결하므로 실행 경로와 환경변수, 프로세스 권한이 동작에 영향을 줍니다. 설정 파일에 서버 이름을 적는 것만으로 올바른 프로그램이 실행되는지는 알 수 없습니다. 실제 실행 파일과 인수, 로그를 확인하되 자격 증명은 진단 결과에 노출하지 않습니다.