aiterm-mcp를 통해 서버 작업 시 토큰 낭비 61% 절감하기

로그에서의 토큰 낭비를 61% 줄이고, SSH 재연결의 반복적인 코드(boilerplate)를 제거하며, Claude Code가 읽기 전에 출력을 정리해 주는 지속적인 터미널 MCP 서버인 aiterm-mcp를 설치하세요.

변경 사항 — aiterm-mcp: 지속적인 터미널 MCP 서버

aiterm-mcp라는 새로운 MCP 서버가 npm에 게시되었습니다. 이 서버는 Claude Code가 매 명령마다 새로운 셸(shell)을 생성하는 대신, 단일한 지속적 터미널 세션을 가질 수 있도록 합니다. 이를 통해 모든 SSH 또는 서버 작업 시 조용히 토큰을 소모하는 "연결 → 인증 → 실행 → 연결 해제" 주기를 제거합니다.

사용자에게 미치는 영향 — 일상적인 Claude Code 사용에 대한 구체적인 영향

Claude Code에 서버 명령 실행을 요청하면, 일반적으로 한 번에 하나의 명령을 보냅니다. SSH의 경우, 이는 매번 ssh host "command"를 실행함을 의미합니다. 각 호출은 전체 연결, 인증, 그리고 MOTD(Message of the Day) 반복 코드(boilerplate)를 반복합니다. 저자는 SSH 로그인 시 MOTD만으로 연결당 약 385개의 토큰이 소모됨을 측정했습니다. 10개의 명령으로 구성된 작업의 경우, 실제 작업이 시작되기도 전에 순수 반복 코드(boilerplate)로만 3,800개의 토큰이 소모됩니다.

aiterm-mcp는 하나의 터미널 세션을 유지함으로써 이 문제를 해결합니다. SSH는 한 번만 연결됩니다. cd 명령과 환경 변수가 유지됩니다. 이후의 모든 명령은 동일한 세션을 통해 직접 전송됩니다. MOTD 토큰 비용은 한 번만 지불하면 되며, 그 이후에는 비용이 발생하지 않습니다.

하지만 더 놀라운 점은, aiterm-mcp가 Claude Code가 읽기 전에 출력을 가지치기(pruning)한다는 것입니다. 제어 문자(control characters)를 제거하고, 반복되는 줄을 접으며(folds), 긴 출력은 (앞부분과 뒷부분만 남기고) 자르고(truncates), 심지어 git status, git log, grep, pytest와 같은 일반적인 명령어를 핵심 요점으로 요약합니다. 저자는 120줄의 journalctl 로그를 대상으로 61%의 절감 효과를 측정했습니다.

지금 바로 사용해 보세요 — 설치 및 사용법

설치는 단 하나의 명령어로 가능합니다. 클로닝(cloning)이나 빌드(building)가 필요하지 않습니다:

claude mcp add --scope user --transport stdio aiterm -- npx -y aiterm-mcp

Claude Code를 재시작한 후, /mcp로 확인하세요. pty_open, pty_send, pty_read, pty_send_key, pty_close, pty_list라는 6개의 새로운 도구가 보일 것입니다.

요구 사항:

• Node.js 18 이상
• tmux (apt install tmux / brew install tmux)
• Linux / WSL2 / macOS (Windows는 WSL로 연결)

실제 사용 방법:

1. 터미널 열기: pty_open이 tmux 세션을 생성합니다.
2. SSH 한 번 접속: pty_send("ssh 192.168.1.2") — 인증은 여기서 단 한 번 이루어집니다.
3. 명령어 실행: pty_send("uname -a"), pty_send("docker ps -a") 등을 실행합니다. 모든 명령은 동일한 SSH 세션에서 실행됩니다.
4. 가지치기된 출력 읽기: pty_read는 제어 문자가 제거되고, 반복되는 줄이 접히며, 긴 내용이 잘린 출력을 반환합니다.

터미널이 tmux를 기반으로 작동하기 때문에, Claude Code를 재시작해도 세션이 유지됩니다. 또한 tmux attach를 통해 AI가 작업하는 모습을 실시간으로 지켜볼 수도 있습니다.

솔직한 참고 사항: 이것이 왕복(round-trips) 자체를 없애지는 않습니다. Claude Code는 여전히 전송하고, 읽고, 결정해야 합니다. 이 도구가 제거하는 것은 **왕복당 비용(cost per round-trip)**입니다. 즉, 재인증, 재설정, 그리고 출력 노이즈가 사라지는 것입니다.

출처: dev.to

원문 게시지: gentic.news