Claude Code MCP 서버에서 stdin 응답이 멈추는 현상

Question

자체 MCP(Model Context Protocol) 서버를 stdio transport로 만들고 있습니다. Claude Code에 연결했더니 처음 몇 번 호출은 잘 되는데, 5~10분 사용 후 응답이 멈춰서 다시 안 옵니다.

서버 프로세스는 살아 있고 stderr에 에러도 안 찍힙니다. 재시작하면 또 잠시 동작합니다.

stdin/stdout 버퍼 문제 같은데 정확한 원인과 해결법이 궁금합니다.

김영삼 · Accepted Answer

MCP stdio 서버에서 가장 흔한 deadlock입니다. 원인은 거의 항상 stdout 버퍼 + 동기 write 조합입니다.핵심 메커니즘Node.js의 process.stdout.write는 stdout이 파이프(터미널이 아닌)일 때 버퍼링됩니다. Claude Code가 부모 프로세스라 stdout은 파이프 모드입니다. 한편 클라이언트가 stdin으로 다음 메시지를 안 보내고 있는 동안 서버는 응답을 stdout에 썼다고 생각하지만 실제로는 OS 버퍼에 쌓이고 있습니다.버퍼가 차면 write가 backpressure를 일으키고, 잘못 처리하면 영영 안 풀립니다.잘못된 패턴 (자주 보는 케이스):// stdout 버퍼 안 비워짐
process.stdout.write(JSON.stringify(response) + '
')
// 다음 요청 처리로 바로 넘어감올바른 패턴:function send(payload) {
  return new Promise((resolve, reject)

댓글 0