Mibayy/token-savior

这是什么？

核心功能

• 01符号级代码导航，支持查找符号及查询依赖关系
• 02基于 SQLite 的持久记忆，支持全文检索和可选的向量检索
• 03PreToolUse 钩子可在命令执行前改写 Bash 命令，减少输出
• 04针对 git、测试框架、云厂商 CLI 和 Docker 的 34 个输出压缩器
• 05可配置的工具档位，`ts init` 可一键接入多种编程助手

适用场景

• 在大型代码库中避免智能体反复整文件读取，改为按符号快速定位代码
• 在多次 Claude Code 会话之间保留架构决策与缺陷修复记录
• 降低智能体进行反复代码导航和测试运行时的 token 成本与耗时
• 通过 ts 命令行工具，让 Cursor 等不支持 MCP 的工具或脚本使用符号查询

快速上手

1. 1

   从 PyPI 安装带 MCP 支持的包

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

   在 MCP 配置中添加该服务器（例如 Claude Code），并设置工作区根目录和配置档

使用前须知

• !作者公布的基准测试数据无法独立验证，其测试工具仓库也未公开。
• !Claude Code 用户必须将 alwaysLoad 设为 true，否则工具会隐藏在 ToolSearch 之后，几乎不会被调用。
• !PostToolUse 的 Bash 压缩器不会减少当前轮次的 token，只有 PreToolUse 重写器能做到。

收录于专题

标签

常见问题

token-savior 是什么？

面向 AI 编程助手的 MCP 服务，按符号索引代码并提供持久记忆与 Bash 命令改写，以减少 token 消耗。 Token Savior 是一个 MCP 服务器，位于 Claude Code 等 AI 编程助手与代码库之间。它按符号（函数、类、导入及调用图）为项目建立索引，让模型通过定位信息回答问题，而不必整文件读取。

token-savior 可以免费使用吗？用的什么许可证？

token-savior 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

token-savior 还在维护吗？

活跃维护中。token-savior 最近一次提交是在 2026年10月15日。

token-savior 适合用来做什么？

在大型代码库中避免智能体反复整文件读取，改为按符号快速定位代码 在多次 Claude Code 会话之间保留架构决策与缺陷修复记录 降低智能体进行反复代码导航和测试运行时的 token 成本与耗时 通过 ts 命令行工具，让 Cursor 等不支持 MCP 的工具或脚本使用符号查询

token-savior 怎么安装和运行？

从 PyPI 安装带 MCP 支持的包: pip install "token-savior-recall[mcp]" 在 MCP 配置中添加该服务器（例如 Claude Code），并设置工作区根目录和配置档

在哪里获取 token-savior？

源代码和安装说明在 GitHub 上：https://github.com/Mibayy/token-savior