Repolode
Enviar
Mibayy

Mibayy/token-savior

Servidor MCP para agentes de programación con IA que indexa el código por símbolo y añade memoria persistente y reescritura de comandos Bash para reducir el uso de tokens.

Ver en GitHubSitio web
Estrellas
1,209
Forks
110
Issues abiertos
9
Último commit
hace 23 días

¿Qué es?

Token Savior es un servidor MCP que se interpone entre un agente de programación con IA, como Claude Code, y tu base de código. En vez de permitir que el modelo lea archivos completos para responder preguntas concretas, indexa el proyecto por símbolo (funciones, clases, imports y el grafo de llamadas), de modo que el agente pueda consultar una definición o sus dependencias mediante un puntero, sin leer los archivos enteros.

También incluye un motor de memoria persistente que almacena decisiones, correcciones de errores, convenciones y resúmenes de sesiones en SQLite con búsqueda de texto completo y búsqueda vectorial opcional; después, al inicio de la siguiente sesión, vuelve a insertar un resumen compacto. Un reescritor Bash de PreToolUse puede modificar los comandos antes de que se ejecuten para reducir su salida, y los compactadores de PostToolUse presentan herramientas habituales, como git, pytest, kubectl y aws, en un formato condensado.

El servidor ofrece perfiles de herramientas que van desde una sola herramienta hasta 68, y el comando `ts init` configura hooks en Claude Code, Cursor, Gemini, Codex y OpenClaw. También hay una CLI (`ts`) para agentes sin compatibilidad con MCP.

Funciones clave

  • 01Navegación del código por símbolo, incluida la búsqueda con find_symbol y de dependencias en el grafo de llamadas
  • 02Memoria persistente en SQLite con búsqueda de texto completo y búsqueda vectorial opcional
  • 03Reescritor Bash de PreToolUse que reduce la salida de los comandos antes de que llegue al modelo
  • 0434 compactadores de PostToolUse para git, ejecutores de pruebas, CLI de servicios en la nube y Docker
  • 05Perfiles de herramientas configurables y el comando `ts init` para Claude Code, Cursor, Gemini, Codex y OpenClaw

Casos de uso

  • Trabajar con una base de código grande en la que un agente vuelve a leer archivos enteros para encontrar fragmentos pequeños
  • Mantener disponibles las decisiones arquitectónicas y las notas sobre correcciones de errores entre varias sesiones de Claude Code
  • Reducir el costo en tokens y la latencia de un agente que repite tareas de navegación y ejecución de pruebas
  • Dar acceso al shell a herramientas sin MCP, como Cursor, o a scripts para consultar símbolos mediante la CLI ts

Inicio rápido

  1. 1

    Instala el paquete desde PyPI con compatibilidad con MCP

    pip install "token-savior-recall[mcp]"
  2. 2

    Añade el servidor a tu configuración de MCP (p. ej., Claude Code) e indica las raíces de tu espacio de trabajo y el perfil

Antes de usarlo

  • Las cifras principales del benchmark las ha comunicado el autor y el repositorio del arnés no es público, por lo que no se pueden verificar de forma independiente.
  • Los usuarios de Claude Code deben establecer alwaysLoad en true; de lo contrario, las herramientas quedan ocultas tras ToolSearch y apenas se usan.
  • Los compactadores Bash de PostToolUse no reducen los tokens del turno actual; solo lo hace el reescritor de PreToolUse.

En colecciones

Servidores MCP para Claude CodeHerramientas, skills y plugins para Claude CodeFrameworks y apps de agentes de IA open sourceServidores MCP

Temas

#mcp#claude-code#ai-agent#code-navigation#token-optimization#persistent-memory#python#developer-tools

Preguntas frecuentes

¿Qué es token-savior?
Servidor MCP para agentes de programación con IA que indexa el código por símbolo y añade memoria persistente y reescritura de comandos Bash para reducir el uso de tokens. Token Savior es un servidor MCP que se interpone entre un agente de programación con IA, como Claude Code, y tu base de código. En vez de permitir que el modelo lea archivos completos para responder preguntas concretas, indexa el proyecto por símbolo (funciones, clases, imports y el grafo de llamadas), de modo que el agente pueda consultar una definición o sus dependencias mediante un puntero, sin leer los archivos enteros.
¿token-savior es gratuito? ¿Qué licencia tiene?
token-savior es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿token-savior sigue mantenido?
Mantenimiento activo. El último commit de token-savior fue el 15 oct 2026.
¿Para qué puedo usar token-savior?
Trabajar con una base de código grande en la que un agente vuelve a leer archivos enteros para encontrar fragmentos pequeños Mantener disponibles las decisiones arquitectónicas y las notas sobre correcciones de errores entre varias sesiones de Claude Code Reducir el costo en tokens y la latencia de un agente que repite tareas de navegación y ejecución de pruebas Dar acceso al shell a herramientas sin MCP, como Cursor, o a scripts para consultar símbolos mediante la CLI ts
¿Cómo se instala token-savior?
Instala el paquete desde PyPI con compatibilidad con MCP: pip install "token-savior-recall[mcp]" Añade el servidor a tu configuración de MCP (p. ej., Claude Code) e indica las raíces de tu espacio de trabajo y el perfil
¿Dónde consigo token-savior?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Mibayy/token-savior

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados