token-lens

token-lens-mcp

用于分析和优化上下文窗口 token 用量的 MCP 服务。在用户开始任何工作之前，MCP 工具定义就会占用上下文窗口的 40–72%；此服务可帮助你衡量、压缩并消除这部分浪费。

安装

npx token-lens-mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "token-lens": {
      "command": "npx",
      "args": ["token-lens-mcp"]
    }
  }
}

Claude Code

claude mcp add token-lens -- npx token-lens-mcp

工具

audit_context_budget

分析 MCP 工具定义的 token 开销。使用完整 JSON 定义，按字符数除以 4 的近似值估算每个工具的 token 数。

参数：

• tools — {name, description, schema} 对象数组

**返回：**按开销排序的各工具 token 开销、总 token 数，以及占 128K/200K/1M 上下文窗口的百分比。

optimize_tool_loading

根据任务描述，推荐所需的最小工具集。使用关键词匹配和类别相关性评分。

参数：

• task_description — 你要完成的任务
• available_tools — {name, description, category?} 对象数组

**返回：**按相关性排序的推荐工具、排除的工具，以及预计节省的 token 数。

compress_schema

压缩冗长的工具架构，以减少 token 用量。

参数：

• tool_name — 工具名称
• schema — 要压缩的 JSON Schema 对象
• level — "light" | "medium" | "aggressive"

级别：

• light — 删除少于 20 个字符的描述
• medium — 将描述缩短至 50 个字符，删除示例
• aggressive — 删除所有描述，仅保留类型和必填字段

**返回：**压缩后的架构、压缩前后的 token 数，以及节省的百分比。

analyze_session_usage

跟踪会话期间实际调用的工具与已加载工具的情况。

参数：

• session_id — 唯一会话标识符
• action — "register_tool" | "log_call" | "report"
• tool_name — 工具名称（register_tool/log_call 必填）
• tool_tokens — token 开销（用于 register_tool，默认值为 50）

**报告返回：**已加载与已使用工具的数量、浪费百分比，以及按 token 开销排序的未使用工具。

suggest_removals

根据使用模式识别可安全移除的工具。

参数：

• usage_history — {tool_name, call_count, last_used_days_ago} 对象数组

**评分：**从未使用 (优先级 3) > 30 天未使用 (优先级 2) > 很少使用 (优先级 1)

**返回：**附有原因和预计 token 节省量的移除候选工具。

get_optimization_report

全面检查上下文窗口状况，综合分析结果、移除建议和压缩建议。

参数：

• tools — 工具定义数组
• usage_history — 可选的使用历史数组

**返回：**包含健康评级（excellent/good/fair/poor）、分析结果、移除建议、压缩机会和可执行建议的摘要。

资源

token-lens://tips

减少 MCP 上下文窗口膨胀的最佳实践指南，包含架构设计技巧、token 预算指南和动态工具加载策略。

开发

npm install
npm test
npm run dev  # watch mode

许可证

MIT