Ferramenta Open Source para Reduzir Desperdício de Tokens do Claude Code em 70%

O que é o ContextOpt?

ContextOpt é um proxy inteligente que fica entre seu agente de IA e seus servidores MCP. Ele filtra ferramentas por perfil, para que apenas as relevantes consumam contexto.

Agente de IA (Claude Code)
       │
       ▼
┌─────────────────┐
│  ContextOpt      │  ← Filtra ferramentas por perfil
│  Motor Proxy     │  ← Inicia servidores de forma preguiçosa
└────────┬────────┘
         │
    ┌────┴────┐
    ▼         ▼
filesystem  github  ... (apenas servidores de perfil ativo)

O Problema

Aqui está uma configuração típica do MCP para Claude Code:

{
  "mcpServers": {
    "filesystem": { "command": "npx", "args": ["-y", "@anthropic/mcp-filesystem"] },
    "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/github"] },
    "playwright": { "command": "npx", "args": ["-y", "@anthropic/mcp-playwright"] },
    "sequential-thinking": { "command": "npx", "args": ["-y", "@anthropic/mcp-sequential-thinking"] },
    "memory": { "command": "npx", "args": ["-y", "@anthropic/mcp-memory"] }
  }
}

Isso é 5 servidores → ~78 definições de ferramentas → ~19.500 tokens por prompt. Cada. Mensagem. Única.

Se você enviar 50 mensagens por dia, isso é quase 1M tokens/mês apenas em definições de ferramentas — cerca de $90/mês no Claude Sonnet.

A Solução: Filtragem Baseada em Perfil

Em vez de carregar todas as ferramentas o tempo todo, o ContextOpt agrupa servidores em perfis:

Quando você está codificando, não precisa do Playwright. Quando você está depurando, não precisa do GitHub. Simples.

Como Funciona

1. Analise sua configuração atual

npx contextopt analyze

Isso lê sua configuração do MCP (detecta automaticamente Claude Code, Cursor ou Windsurf) e mostra uma análise do uso de tokens por servidor, custo estimado e economia potencial.

2. Escolha um perfil

# Liste os perfis disponíveis
npx contextopt profile -l

# Mude para o perfil de codificação
npx contextopt profile -s coding

# Crie um perfil personalizado
npx contextopt profile -c myprofile --servers "github,filesystem"

3. Inicie o proxy

npx contextopt start --profile coding

O proxy se conecta apenas aos servidores em seu perfil ativo, descobre suas ferramentas e expõe a lista filtrada ao seu agente de IA. Servidores que você não precisa nunca são iniciados — economizando tanto tokens quanto recursos do sistema.

Modo HTTP (Pro)

Para conexões remotas, você pode executar o proxy em modo HTTP:

npx contextopt start --http --port 3456

Isso usa Streamable HTTP como transporte, então qualquer cliente compatível com MCP pode se conectar.

O Painel Web

Você não precisa usar a CLI se preferir uma interface visual. O painel ao vivo permite que você:

• Cole sua configuração do MCP e veja uma análise instantânea de tokens
• Compare economias entre perfis
• Veja a análise por servidor com gráficos
• Calcule suas economias mensais

O Que Aprendi Construindo Isso

Isso foi meu f