activeing123/mcptoon

★ 18PythonApache-2.0

MCP 도구 1000개를 붙여도 AI 대화창이 텅 비게 만드는 CLI 도구

AI 에이전트가 외부 도구(MCP 서버)를 여러 개 연결하면 도구 설명서(스키마)만으로 컨텍스트 창이 수만 토큰씩 차버린다. mcptoon은 이 스키마를 컨텍스트에 아예 넣지 않고, 에이전트가 셸 명령으로 필요할 때만 도구를 호출하게 만들어 이 문제를 없앤다. 결과값도 TOON이라는 압축 표기법으로 줄여서 JSON 대비 최대 93%까지 토큰을 아낀다.

무엇을 하는 레포인가

MCP(Model Context Protocol)는 AI 에이전트가 외부 도구를 쓰게 해주는 표준인데, 기존 방식은 도구 목록의 스키마(입출력 형식 설명)를 실행 시작 시 전부 컨텍스트 창에 로드해 서버 10개만 붙여도 5만~10만 토큰이 날아간다.
mcptoon은 별도 MCP 서버가 아니라 CLI 도구로 작동한다. 에이전트가 mcpServers 설정 파일을 건드리는 대신 셸에서 mcptoon 명령어를 실행하면, 도구 스키마는 디스크의 설정 파일에만 있고 컨텍스트 창에는 들어가지 않는다.
도구는 필요할 때만 서버를 켜는 지연 로딩 방식이라 1000개를 등록해도 실제 호출 전까지는 0개만 실행 상태다.
호출 결과는 TOON, SLIM, Compact 세 가지 압축 표기법으로 반환할 수 있는데, 저장소 측정에 따르면 tiktoken cl100k_base 토크나이저 기준 도구 255개의 스키마가 JSON 9만804토큰에서 압축(Compact)시 117토큰(99.9% 절감), SLIM 적용 시 6174토큰(93% 절감), TOON 적용 시 결과값 자체가 JSON 대비 30~40% 작아진다.
프롬프트 인젝션 탐지, 자격증명 유출 탐지, 삭제 같은 위험 작업 차단 등 3중 보안 가드가 내장돼 있고, 순수 파이썬 표준 라이브러리만 써서 외부 의존성이 0개다.

왜 중요한가

에이전트를 여러 개 갈아타며 쓰는 개발자라면 매번 도구 설정을 다시 하지 않아도 되고, 컨텍스트 창을 스키마가 아니라 실제 작업 내용으로 채울 수 있다. 도구 개수가 많아질수록 기존 방식은 컨텍스트가 죽지만 mcptoon은 확장성 문제 자체를 없앤다.

이 레포의 용어

MCP(Model Context Protocol) · AI 에이전트가 외부 도구나 서버를 표준화된 방식으로 호출하게 해주는 프로토콜
컨텍스트 창 · AI 모델이 한 번에 참고할 수 있는 입력 텍스트의 최대 범위
스키마 · 도구가 어떤 입력을 받고 어떤 출력을 내는지 정의한 명세
TOON · JSON보다 적은 토큰으로 구조화된 데이터를 표현하도록 설계된 개방형 표기 형식
지연 로딩(lazy-load) · 실제로 호출될 때까지 프로그램(서버)을 실행하지 않는 방식

레포 원문 소개 (영문)

Token-efficient MCP CLI client. 97% less tokens on tool discovery, 40-60% on results. Zero deps. Cross-platform. Works with every AI agent.

GitHub에서 보기

주목받는 레포

레포 전체 보기 →

activeing123/mcptoon

무엇을 하는 레포인가

왜 중요한가

이 레포의 용어

주목받는 레포

METAL MEDIA 최신 기사