Toolc: proxy pro MCP v VS Code — úspora 60%

Optimalizace MCP nástrojů pro agenty VS Code: kompaktní Go proxy

Agenti v rozšířeních VS Code, jako Cline, Roo Code nebo Kilo, rychle hromadí MCP servery: přístup k souborům, vyhledávání, databáze, GitHub, Jira, OpenAPI. Konfigurační soubor mcp.json narůstá na 25+ serverů. Model vynakládá kontext na parsování chaosu: konflikty názvů (search se duplikuje), dlouhé popisy, halucinace argumentů. Výsledek — růst nákladů na tokeny bez užitku.

Proxy toolc v Go agreguje servery do jediného MCP rozhraní. Filtrováno duplicity, komprimuje popisy, řídí viditelnost nástrojů. Pro VS Code — jeden server místo zvířecí farma.

Instalace a spuštění

Stáhněte binárku z Releases nebo zkompilujte ze zdrojů:

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

Optimalizujte konfiguraci:

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

Spusťte bránu:

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

Nová konfigurace se připojí ve VS Code jako běžný MCP server. Agent dostane komprimovaný katalog bez zbytečných požadavků.

Interní architektura

toolc převádí MCP, OpenAPI do mezireprezentace (IR). Aplikovat tři režimy kompilace:

• direct: plná schéma bez změn — pro ladění.
• flat: plochý seznam, deduplikace, komprese popisů — hlavní režim.
• staged: discovery podle názvů, schémata na požádání — pro složité API.

Parser OpenAPI je odolný vůči velkým specifikacím (Stripe API): ochrana hloubky, opětovné použití mělkých ref-shell. Paměť — ~48 MB, čas — milisekundy.

Benchmarky úspory tokenů

Testování na GitHub API (1100 endpointů), Stripe. Modely: Qwen-3.6-plus, GLM-5.1, GPT-5.4, Claude Sonnet 4.6. Náklady na milion volání (režim flat vs direct):

| Model | Bez proxy ($) | S toolc ($) | Úspora (%) |

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

| 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 |

Úspěšnost zůstává vysoká. Flat minimalizuje token proxy.

Případ s GLM-5.1: halucinace a opravy

GLM-5.1 selhávala na přerušených JSON, zapomínala kontrakty. Příčiny:

• Jednotný systémový prompt pro orchestraci.
• Nedostatek budgetu pro dokončení.

Oprava: izolované prompty, zvýšené limity. Úspěšnost z 0.78 na 0.92 ve flat.

Náročné modely vyžadují tvarování požadavků kromě kompilace.

Omezení a plány

Podpora:

• Lokální MCP stdio.
• OpenAPI.
• Kontext agentů VS Code.

Nepodporováno:

• Vzdálené MCP.
• Generické funkce.
• OpenAI-kompatibilní runtime (ve vývoji).

Architektura je škálovatelná pro control plane.

Co je důležité

• toolc snižuje náklady o 33–60 % díky kompresi katalogů MCP/OpenAPI.
• Tři režimy: flat je optimální v poměru cena/výkon.
• Parser zvládá rekurzivní API (Stripe) bez OOM.
• Úspěšnost modelů roste při čistém kontextu.
• Kompatibilní s VS Code bez přepisování konfigurací.

— Editorial Team