Token Optimizer MCP

选型与风险

安装接入

{
  "mcpServers": {
    "token-optimizer": {
      "command": "npx",
      "args": ["-y", "@ooples/token-optimizer-mcp@latest"],
      "env": {
        "TOKEN_OPTIMIZER_CACHE_DIR": "/path/to/cache"
      }
    }
  }
}

{
  "servers": {
    "token-optimizer": {
      "command": "npx",
      "args": [
        "-y",
        "@ooples/token-optimizer-mcp@latest"
      ],
      "env": {
        "TOKEN_OPTIMIZER_CACHE_DIR": "/path/to/cache"
      }
    }
  }
}

claude mcp add token-optimizer -e TOKEN_OPTIMIZER_CACHE_DIR=/path/to/cache -- npx -y @ooples/token-optimizer-mcp@latest

验证是否装好

在客户端工具列表中确认出现 token-optimizer 的工具（如 smart_read、token_audit），然后运行 npx token-optimizer-doctor 验证钩子能拒绝大文件读取并正常回答；或直接发送一个 token_audit 请求，有返回即说明连接成功。

常见排障

1. 若感觉没有任何效果，通常是没有安装生命周期钩子包：MCP 服务器进程无法修改宿主，且 npm 11 默认限制 lifecycle scripts，需按客户端安装插件或钩子
2. 运行 npx token-optimizer-doctor，它会向真实的钩子二进制喂入合成载荷，验证大文件读取被拒绝
3. 启用代理后无法启动代理进程：检查端口占用与回环绑定，并确认 Node.js 版本 ≥22
4. 知识图谱的语义采集显示 off:no-key 时表示未配置模型凭据，可指向本地模型端点以保持离线；用 npx token-optimizer-doctor 查看当前状态
5. 想排查钩子运行状况时运行 npm run diagnostics，可加 --hours 与 --output 参数；原始事件行需显式开启且上限 1000 条
6. 需要临时关闭时设置 TOKEN_OPTIMIZER_MODE=off；关闭代理路由可设置 TOKEN_OPTIMIZER_PROXY=0

试试这样问

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

• 用 smart_read 读取 src/auth.ts 的关键部分，不要整文件读取复制
• 运行 token_audit，列出本会话中最耗费 token 的操作并给出修复建议复制
• 用 wiki_read 查一下之前会话中关于认证模块的结论，避免重复推导复制
• 用 smart_grep 在代码库中搜索数据库连接池相关的代码复制

工具能力 11

没有匹配的工具

使用场景

支持客户端

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

详细介绍

同类可选方案