Toolc: VS Code에서 MCP용 프록시 — 60% 절감

VS Code 에이전트용 MCP 도구 최적화: 컴팩트 Go 프록시

Cline, Roo Code, Kilo 같은 VS Code 에이전트 확장은 파일 접근, 검색, 데이터베이스, GitHub, Jira, OpenAPI 등 MCP 서버를 빠르게 늘려갑니다. mcp.json 설정 파일이 25개 이상 서버로 부풀어 오릅니다. 모델이 이 혼란을 파싱하느라 컨텍스트를 낭비하죠: 이름 충돌(search 중복), 장황한 설명, 인자 환각 현상. 결과? 실질적 이득 없이 토큰 비용만 폭증.

toolc Go 프록시는 서버들을 단일 MCP 인터페이스로 통합합니다. 중복 제거, 설명 압축, 도구 가시성 제어를 처리하죠. VS Code에서는 동물원 같은 서버 대신 하나만 필요합니다.

설치 및 설정

릴리스에서 바이너리를 다운로드하거나 소스에서 빌드하세요:

go install github.com/aak204/Tool-Catalog-Compiler/cmd/[email protected]

설정 최적화:

./toolc optimize-mcp \
  -input .vscode/mcp.json \
  -emit vscode \
  -out-dir dist/mcp-optimized

게이트웨이 실행:

./toolc mcp-serve -catalog dist/mcp-optimized/toolc.compiled.json

새 설정을 일반 MCP 서버처럼 VS Code에 연결하세요. 에이전트는 추가 쿼리 없이 간결한 카탈로그를 받습니다.

내부 아키텍처

toolc는 MCP와 OpenAPI 명세를 중간 표현(IR)으로 변환합니다. 세 가지 컴파일 모드를 적용하죠:

• direct: 전체 스키마 그대로 — 디버깅용.
• flat: 중복 제거와 설명 압축된 플랫 리스트 — 기본 모드.
• staged: 이름 기반 발견, 주문형 스키마 — 복잡한 API용.

OpenAPI 파서는 Stripe API 같은 거대 명세를 깊이 제한과 얕은 참조 재사용으로 처리합니다. 메모리 사용: ~48 MB. 처리 시간: 밀리초 단위.

토큰 절감 벤치마크

GitHub API(1,100 엔드포인트)와 Stripe로 테스트. 모델: Qwen-3.6-plus, GLM-5.1, GPT-5.4, Claude Sonnet 4.6. 백만 호출당 비용(flat vs direct):

| 모델 | 프록시 없음 ($) | toolc 사용 ($) | 절감률 (%) |

|----------------------------|-----------------|----------------|------------|

| qwen/qwen3.6-plus | 1807.26 | 1199.13 | 33.65 |

| z-ai/glm-5.1 | 3102.53 | 1593.14 | 48.65 |

| openai/gpt-5.4 | 8819.46 | 4291.96 | 51.34 |

| anthropic/claude-sonnet-4.6 | 10736.57 | 4290.21 | 60.04 |

성공률은 높게 유지됩니다. flat 모드가 토큰 프록시 오버헤드를 줄입니다.

GLM-5.1 사례 연구: 환각 현상과 해결

GLM-5.1은 잘린 JSON에 막혀 계약을 잊어버렸습니다. 원인:

• 오케스트레이션용 일률적 시스템 프롬프트.
• 부족한 완성 예산.

해결: 격리된 프롬프트와 한도 상향. flat 모드 성공률이 0.78에서 0.92로 상승.

까다로운 모델은 컴파일 외에 요청 형성도 필요합니다.

제한사항과 로드맵

지원:

• 로컬 MCP stdio.
• OpenAPI.
• VS Code 에이전트 컨텍스트.

미지원:

• 원격 MCP.
• 제네릭 함수.
• OpenAI 호환 런타임(진행 중).

아키텍처는 전체 제어 평면으로 확장 가능합니다.

주요 요약

• toolc가 MCP/OpenAPI 카탈로그 압축으로 비용 33–60% 절감.
• 세 모드 중 flat이 가격/성능 최적.
• 파서가 Stripe 같은 재귀 API 처리에 안정적.
• 깔끔한 컨텍스트로 모델 성공률 향상.
• VS Code 즉시 사용, 설정 재작성 불필요.

— Editorial Team