← 返回目录

Token-Goat

社区

非标准 Server

减少 AI 编程上下文浪费，提升读取专注度。

这不是典型的可直接连接的 MCP Server，使用前请先阅读源仓库说明。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 327 / 438
Stars: ★ 141 非常热门
运行环境: Node.js 22+
凭据: 无需凭据
许可证: 其他 / 未声明
最近提交: 9 天前

43FMRS · D

这是一个面向 AI 编程 CLI 的本地 token 优化和钩子工具，不是证据充分的独立 MCP server：来源没有提供 server manifest、MCP transport 或工具清单。其主要价值是减少上下文噪声和重复读取；部署时应重点审查配置修改、文件访问、缓存留存以及各客户端桥接的验证状态。

最强项 · 文档质量 13/20 最弱项 · 可靠性 4/20

可靠性

4/20

安全与权限

8/20

维护活跃度

8/20

文档质量

13/20

安装易用性

10/20

查看各项评分依据

可靠性 4/20: 未提供服务器清单，也没有 MCP 初始化、工具列表或实际执行证据；README 主要描述 hooks、CLI 和多客户端桥接，而不是可验证的 MCP server 接口。README 提到 CI、测试和大量错误处理，但这些内容未由源文件证实，因此只能给出较低分。
安全与权限 8/20: README 描述了提示注入扫描、非可信内容围栏、fail-soft hooks 和可禁用配置，但未提供实现、权限模型、凭据处理、网络数据边界或危险操作确认的证据。安装会修改用户配置并注册 hooks，且工具重写/阻止行为可能影响工作流；没有足够证据支持更高分，但未发现明确的红线风险。
维护活跃度 8/20: 仓库未归档，公开信息显示 62 stars、0 个 open issues，README 给出 npm 手动更新路径和联系邮箱，说明存在维护入口。扣分原因是 license 为 NOASSERTION，README 的 PolyForm Noncommercial 标识未得到清晰源文件证实，且缺少可核验的发布、提交、依赖更新和安全响应记录。
文档质量 13/20: README 极其详尽，覆盖安装、Node.js 版本、多个客户端、限制、故障排查、卸载、缓存恢复和配置开关，并明确披露部分桥接未经实时验证。扣分原因是 manifest 缺失，文档包含大量未经源文件验证的性能和功能声明，且提供内容在末尾截断，无法完整审查参数与边界。
安装易用性 10/20: README 给出 npm 全局安装、install、doctor 三步流程，并说明 Node.js 22+、Windows/Linux/WSL 及多种客户端桥接。扣分原因是安装会修改多个用户级配置、依赖 hooks 和可选后台 worker，部分客户端需要额外桥接或重启，且没有可验证的 MCP 连接配置或成功握手示例。

静态评测 · 未实际运行收录于 2026-07-30

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络

适合谁

经常使用 Claude Code、Codex CLI、Gemini CLI 或其他支持集成的 AI 编程 CLI 的开发者。
希望减少大型代码库、长日志、截图和技能文件带来的上下文消耗的用户。
能够接受工具修改本地 AI 客户端配置并创建索引、缓存的用户。

不适合谁

需要标准 MCP server manifest、明确 MCP transport 或可直接连接的 MCP 工具列表的用户。
不希望安装全局 npm 包、注册钩子或修改客户端配置的用户。
需要 macOS 已验证支持的生产环境用户；README 将 macOS 标为未测试。

所需权限

需要安装 Node.js/npm 全局包。
需要写入相应 AI 客户端的用户配置和钩子文件，例如 Claude Code、Gemini、Qwen、Copilot 或 Grok 的配置目录。
需要读取项目文件、Git 信息及会话相关内容，以建立索引、缓存和压缩清单。
后台 worker 如启用，需要在本地作为后台进程运行。

风险与副作用

钩子会拦截或改写读取、Bash、截图和其他工具调用，可能改变原始输出呈现方式。
索引、缓存和会话清单会在本地保存项目或工具输出；README 未提供完整的数据保留或加密说明。
README 声称会扫描网页内容并阻挡提示注入，但该安全能力不应替代人工审查或客户端自身的安全控制。
部分桥接器并未在真实运行实例上验证，包括 Qwen、OpenClaw 和 pi 的相关集成说明；Copilot 的钩子错误可能导致整个会话拒绝工具调用。
项目元数据中的许可证为 NOASSERTION，而 README 徽章显示 PolyForm Noncommercial；使用前应核对仓库许可证文件。

安装接入

准备工作

运行环境：Node.js 22+

其他可选配置项（4 个）

TOKEN_GOAT_MCP_COMPRESS 可选设为 0 可关闭 MCP 工具结果的表格化压缩；默认开启。

TOKEN_GOAT_BASH_COMPRESS 可选设为 0 可全局关闭 bash 输出压缩；默认开启。

TOKEN_GOAT_ASK_BACKEND 可选可选设为 claude 或 codex，让 token-goat ask 命令通过该 CLI 合成简短回答；未设置则只输出检索到的引用。

TOKEN_GOAT_HARNESS_OVERRIDE 可选由 Copilot CLI/pi 等 shim 自动设置为 'copilot_cli' 等值，用于标识当前宿主环境，用户一般无需手动设置。

需要 Node.js 22 或更高版本。运行 npm install -g token-goat，然后运行 token-goat install 和 token-goat doctor。Codex CLI 可使用 token-goat install --codex；Gemini、Qwen、Copilot、OpenCode、pi、Grok CLI 分别有对应安装选项。安装后重启 AI 会话。后台索引器不会由 install 自动启动，如需使用可运行 token-goat worker start。

验证是否装好

安装后运行 token-goat doctor，确认输出包含 'sharp: ok' 且各钩子已注册；然后在 AI 客户端会话中重新读取同一文件，观察是否收到 re-read 提示而不是完整文件内容。

常见排障

运行 `token-goat doctor`，确认钩子和 `sharp` 显示正常。
如果图片处理失败，检查 doctor 输出中的 `sharp: ok`；README 指出 Alpine musl 和部分 ARM 环境可能需要从源码编译。
安装或更新钩子后完全重启 AI CLI 会话，尤其是 Copilot CLI。
使用 `token-goat worker status` 检查索引 worker；必要时运行 `token-goat worker start` 或 `stop`。
若索引过时，可运行 `token-goat index`，或对单个读取命令使用 `--force-refresh`。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我用 token-goat read 只提取 src/auth.py 里的 login 函数，不要读整个文件。
运行 token-goat compress --filter pytest --cmd 'pytest -v tests/'，压缩 pytest 输出。
用 token-goat image-shrink screenshot.png 把这张截图压缩到原来的百分之几。
运行 token-goat stats 看看这个会话节省了多少 token。

使用场景

压缩 pytest、npm、Docker、Git、编译器和其他开发工具的冗长输出。

通过 `token-goat read`、`section`、`symbol` 或 `skeleton` 获取代码和文档的局部内容。

在会话压缩前保存编辑文件、访问过的符号和关键读取记录。

缩小截图并缓存重复的 Bash、网页和 MCP 输出。

为支持的 AI CLI 注册读取、压缩和会话相关钩子。

支持客户端

Claude Code

Codex

Gemini CLI

Qwen Code

GitHub Copilot CLI部分支持

OpenCode部分支持

pi部分支持

Grok CLI部分支持

依据项目文档列出，未经本站实测。

详细介绍

Token-Goat 是一个基于 Node.js 的 CLI 与自动化钩子工具，用于压缩终端输出、缩小图片、拦截重复读取、提取代码或文档片段、生成压缩清单、缓存 Bash/Web/MCP 输出，并扫描网页内容中的提示注入模式。README 声称可减少 40–90% 的 AI token 使用或成本；这些数字来自项目描述和测试基准，实际效果取决于工作流。