← volver a proyectos

@cocaxcode/token-optimizer-mcp

running

Orchestration + observability + coach layer para Claude Code. 13 tools: budgets de tokens, detección de ineficiencias, métricas de uso, tips de optimización y bridge con RTK.

● GitHub ● npm
// tech stack
TypeScriptMCP SDKSQLiteZodVitest
13tools MCP
248tests
18tips de coach
11reglas de detección

¿Por qué token-optimizer-mcp?

Claude Code consume tokens en cada interacción: lecturas de archivos, búsquedas, llamadas a tools. Sin visibilidad, es fácil gastar más de lo necesario. token-optimizer-mcp mide, controla y optimiza ese consumo sin cambiar tu flujo de trabajo.

TipNo reemplaza herramientas como serena (lecturas simbólicas) ni RTK (filtrado de Bash). Las coordina y añade métricas, budgets y coaching.

Instalación

Terminal
claude mcp add --scope user token-optimizer -- npx -y @cocaxcode/token-optimizer-mcp@latest

¿Qué puedes hacer?

Budgets de tokens

Establece límites por sesión o por tarea. Recibe alertas cuando te acercas al límite y reportes de consumo.

Métricas de uso

Ve qué tools MCP consumen más tokens, cuáles son redundantes y dónde hay oportunidades de ahorro.

Coach inteligente

18 tips contextuales que detectan patrones ineficientes: lecturas duplicadas, búsquedas amplias, herramientas infrautilizadas.

Detección de ineficiencias

11 reglas automáticas que identifican uso subóptimo de tools y sugieren alternativas más eficientes.

Bridge con RTK

Integración con RTK (Rust Token Killer) para filtrado de salida de Bash. Coordina el ahorro end-to-end.

Poda de MCPs

Analiza qué MCP servers están instalados pero no se usan, y sugiere desactivarlos para reducir contexto.

Así se ve en la práctica

Establecer budget
Tu: "Pon un budget de 500k tokens para esta sesión"

MCP: budget_set → 500,000 tokens
IA: "Budget establecido. Te avisaré al 75% y 90%.
     Puedes ver el estado con budget_check."
Ver consumo
Tu: "Cuánto llevo gastado?"

MCP: budget_report → métricas detalladas
IA: "125k/500k tokens (25%). Top consumers:
     Read: 45k, Grep: 30k, Agent: 25k."
Tips de optimización
Tu: "Dame consejos para gastar menos"

MCP: coach_tips → análisis de patrones
IA: "3 sugerencias:
     1. Usa Glob en vez de Agent para buscar archivos
     2. Lee solo las líneas que necesitas (offset+limit)
     3. RTK está ahorrando 72% en comandos git"
Analizar MCPs instalados
Tu: "Hay MCPs que no estoy usando?"

MCP: mcp_prune_suggest → analiza uso
IA: "2 MCPs sin uso en 7 días: canva-dev, logbook.
     Desactivarlos ahorraría ~2k tokens de contexto."
HooksIncluye 3 hooks para Claude Code (pre-tool, post-tool, session-start) que capturan métricas automáticamente sin intervención manual.