클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

mcptoon — MCP 툴 카탈로그 압축기

MCP 툴 스키마가 컨텍스트를 잡아먹을 때, 툴 목록을 이름 인덱스로 압축하고 필요한 스키마만 골라 호출하게 해주는 CLI 연동 스킬.

유틸리티중급★ 202⑂ 8AI 점수 9/10마지막 업데이트: 2026. 9. 19.

무엇을 해주나

  • MCP 서버가 여러 개 붙어 툴 스키마만으로 수만 토큰이 소모되는 상황에서 mcptoon manifest로 이름 인덱스만 가져와 컨텍스트를 아낍니다(예시 수치: 255개 툴 71,929 → 581 토큰).
  • 실제 호출 직전에만 mcptoon inspect <server> <tool>로 파라미터 스키마를 가져오고, mcptoon call(또는 --auto, --stdin)로 실행합니다.
  • 이미지·base64처럼 압축하면 안 되는 응답은 mcptoon policy set ... raw로 한 번만 지정해 두면 이후 호출에 계속 적용됩니다.
  • mcptoon skills로 스킬 카탈로그도 관리합니다: 목록/검색(resolve)/여러 에이전트 폴더로 동기화(sync)/추가·삭제, 버전 게이트, Roo·OpenCode용 파생 뷰, 툼스톤 삭제까지.
  • 안전장치가 명시되어 있습니다 — 링크 자리에 실제 디렉터리가 있으면 삭제가 아니라 아카이브, remove는 날짜별 아카이브로 이동, 툼스톤 커밋은 경로 한정 git add만 사용.

이런 분께 추천

  • Claude Code / Cursor / Codex / Cline / Windsurf 등에 MCP 서버를 여러 개 물려 쓰다가 컨텍스트 창이 툴 스키마로 가득 차는 분
  • 같은 MCP 서버·스킬 세트를 여러 에이전트에 동일하게 배포하고 싶은 분
  • 토큰 비용을 실측 기반으로 줄이고 보고하고 싶은 분

활용 예시

  1. "내가 쓸 수 있는 툴 알려줘" → 원시 MCP 목록 대신 mcptoon manifest로 압축 목록 제시 후, 필요한 툴만 inspect해서 호출.
  2. "어느 서버에 있는지 모르겠는데 이 툴 좀 실행해줘" → mcptoon call --auto <tool> '{...}'로 서버 자동 해석.
  3. "스킬 폴더를 Cursor랑 OpenCode에도 똑같이 맞춰줘" → mcptoon skills sync --dry로 미리보기 후 --derived all로 파생 뷰 재생성.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/activeing123/mcptoon/HEAD/claude-code-plugin/skills/mcptoon/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 activeing123/mcptoon 의 claude-code-plugin/skills/mcptoon 폴더를 내 ~/.claude/skills/mcptoon/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

pip install mcptoon && git clone https://github.com/activeing123/mcptoon /tmp/mcptoon && mkdir -p ~/.claude/skills && cp -r /tmp/mcptoon/claude-code-plugin/skills/mcptoon ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. Python과 pip가 설치되어 있는지 확인합니다(python -V, pip -V).
  2. CLI를 설치합니다: pip install mcptoon (약 189KB, 의존성 없음).
  3. 설치 확인 및 진단: mcptoon doctor
  4. Claude Code 사용자 권장 경로: Claude Code에서 /plugin marketplace add activeing123/mcptoon 을 실행하면 CLI 연동 브리지와 이 스킬이 한 번에 설치됩니다.
  5. 수동으로 스킬만 넣고 싶다면: git clone https://github.com/activeing123/mcptoon 후 claude-code-plugin/skills/mcptoon 폴더를 ~/.claude/skills/ 아래로 복사합니다.
  6. 절감량을 직접 측정하려면 pip install tiktoken 후 mcptoon bench 를 실행하세요(없으면 결과는 추정치로 표시됩니다).
  7. 제거는 pip uninstall mcptoon 및 ~/.mcptoon/config.json(및 프로젝트의 ./.mcptoon.json) 삭제로 끝납니다.
GitHub에서 원본 보기 ↗라이선스: Apache-2.0