@tokenzero/mcp

中文文档
0.2.13发布于 2026/11/03Apache-2.0ES Module零依赖

TokenZero MCP server (stdio): audit LLM token waste in your project locally, price model alternatives, and make prompts cache-friendly from Claude Code, Cursor, Windsurf or Cline.

原始使用文档

@tokenzero/mcp

A stdio MCP server from TokenZero that lets coding agents find and fix LLM cost waste.

claude mcp add tokenzero -- npx -y @tokenzero/mcp     # Claude Code
{ "mcpServers": { "tokenzero": { "command": "npx", "args": ["-y", "@tokenzero/mcp"] } } }
ToolRunsWhat it does
audit_repo_token_wastelocallyStatic audit of a local directory (default: the working directory), a public GitHub repo, or a diff. Nothing from a local directory is uploaded.
calculate_model_arbitragelocallyPrices a workload across models at list prices, with and without prompt caching.
optimize_prompt_payloadTokenZero serviceRewrites a request body so its static prefix is cacheable. Sends the body you pass to the TokenZero service (https://tokenzero.sh unless TOKENZERO_URL is set); do not include secrets.
workspace_metricsTokenZero serviceReads a workspace's savings scorecard: hard savings and net ROI per window, each engine's contribution and one-click recommendations. Uses TOKENZERO_KEY unless a key is passed; demo: true returns a labelled sample.
provision_workspaceTokenZero serviceCreates a free workspace and key with no form. The key is returned once.

Optional environment: TOKENZERO_URL (another gateway for optimize_prompt_payload; default https://tokenzero.sh), GITHUB_TOKEN (raises GitHub rate limits for repo audits).

Audits are static heuristics: estimates at list prices, not measurements. Node >= 18. Single file, no dependencies. Apache-2.0.

版本与发布记录

@tokenzero/mcp 共发布 22 个版本,首次发布于 2026/10/26;过去 12 个月发布了 22 个版本。

版本发布日期距今
0.2.13latest2026/11/03今天
0.2.122026/11/021 天前
0.2.112026/11/012 天前
0.2.102026/11/012 天前
0.2.92026/10/295 天前
0.2.82026/10/286 天前

关于 @tokenzero/mcp 的常见问题

@tokenzero/mcp 是什么?

TokenZero MCP服务器(stdio):审计本地项目中的LLM令牌浪费,价格模型替代品,并从Claude Code, Cursor, Windsurf或Cline中生成缓存友好的提示。

如何安装 @tokenzero/mcp?

在项目目录运行 npm install @tokenzero/mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 tokenzero-mcp,可以用 npx tokenzero-mcp 直接运行。

@tokenzero/mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/tokenzero__mcp 是否存在。

@tokenzero/mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@tokenzero/mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@tokenzero/mcp 可以商用吗?

@tokenzero/mcp 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@tokenzero/mcp 还在维护吗?

最新版本 0.2.13 发布于 2026/11/03(今天);至今共发布 22 个版本,其中过去 12 个月发布了 22 个;首次发布于 2026/10/26。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。