Token Guardian MCP

Token Guardian es un servidor MCP local y de solo lectura para encontrar el desperdicio de tokens en Claude Code y Codex sin hacer que ninguno de los dos clientes sea más tonto.

Hace dos trabajos:

• Informa qué agentes, modelos y sesiones están procesando la mayor cantidad de tokens.

• Recomienda el modelo seguro más barato y el nivel de esfuerzo para una tarea específica.

También incluye un comando route-task de prueba en seco para probar el enrutamiento basado en el prompt antes de que el MCP esté registrado en algún lugar.

Límite de seguridad estricto

Token Guardian no puede cambiar la configuración del modelo, los niveles de esfuerzo, los límites de contexto, la compactación, el registro de MCP ni las sesiones en ejecución. No tiene credenciales de modelo y no realiza llamadas API de pago.

La herramienta de uso llama a ccusage con --offline y --no-cost. Los títulos de Codex son metadatos opcionales leídos a través de sqlite3 -readonly. Cada herramienta MCP está marcada como de solo lectura, no destructiva, idempotente y de mundo cerrado.

Related MCP server: token-pilot

Herramientas

token_guardian_usage_snapshot

Lee de uno a treinta días de uso local y devuelve:

• Totales por agente y modelo

• Proporciones de lectura de caché, salida y modelo frontera

• Sesiones más grandes

• Títulos de trabajo duplicados exactos de Codex

• Victorias rápidas respaldadas por evidencia

Los tokens procesados son un diagnóstico de carga de trabajo. No son lo mismo que un medidor de suscripción, especialmente cuando la entrada en caché domina.

token_guardian_recommend_route

Acepta el cliente, la tarea, el riesgo y el tamaño de contexto actual. Devuelve un modelo, nivel de esfuerzo, razones y un validador frontera opcional.

La política falla de forma cerrada. El trabajo de seguridad, arquitectura, producción, destructivo, de alto riesgo, crítico o ambiguo permanece en un modelo frontera. Los modelos baratos manejan trabajo mecánico acotado. Los modelos equilibrados manejan codificación y depuración normales, con una revisión frontera cuando sea necesario.

Probar el enrutamiento basado en el prompt primero

Construye el proyecto, luego ejecuta el enrutador desde cualquier carpeta:

node ./dist/route-cli.js --client codex --prompt "Implement a bounded TypeScript parser with tests." --cwd .

La carpeta de trabajo no necesita ser un repositorio. El enrutador usa principalmente el prompt. Verifica hasta 256 nombres en la carpeta actual en busca de marcadores de proyecto opcionales, sin abrir el contenido de los archivos ni escanear subcarpetas.

El comando solo imprime una recomendación y un comando de lanzamiento con ámbito de sesión. No ejecuta ese comando, no cambia la configuración, no registra el MCP ni toca una sesión activa. Los prompts de continuación vagos como "sí, prueba eso" permanecen en la ruta frontera porque su contexto real falta.

Requisitos locales

• Node.js 24 o más reciente

• ccusage en PATH

• sqlite3 en PATH para títulos de hilos de Codex opcionales

Construir y probar

npm install
npm test
npm run typecheck
npm run build

Ejecuta el servidor stdio construido:

node dist/index.js

Inspecciónalo sin registrarlo en un cliente en vivo:

npx @modelcontextprotocol/inspector node dist/index.js

Estado del registro

Esta primera compilación no está registrada intencionalmente con Claude, Codex ni la puerta de enlace compartida de Kitsune. El registro y cualquier reinicio del cliente son un cambio separado después de que el servidor aislado sea aceptado.

Licencia

MIT. Ver LICENSE.