# TokenZero

TokenZero проверяет код на потери токенов, сравнивает цены моделей и помогает менять запросы для кэширования. Подходит для аудита проекта и pull request.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: tokenzero-ai
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/tokenzero-ai/tokenzero
- Обновлён: 2026-10-28
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/tokenzero

## Что делает

TokenZero подключает к агенту инструменты для аудита расходов на LLM. `audit_repo_token_waste` локально ищет большие промпты без директив кэширования, вызовы моделей внутри циклов, неподходящие дорогие модели и устаревшие или неоценённые идентификаторы. `calculate_model_arbitrage` сравнивает варианты моделей, а `optimize_prompt_payload` подготавливает переданное тело запроса для сервиса.

Аудит читает код, а не историю трафика, поэтому его суммы остаются оценками по табличным ценам. Анализатор работает на вашей машине; есть режим для diff и порог ошибки для CI. MCP-сервер запускается через `npx`, а CLI умеет подключать проект к шлюзу и добавлять адреса провайдеров в `.env` с согласия пользователя.

\`optimize_prompt_payload` отправляет переданное тело на `https://tokenzero.sh`, если не задан `TOKENZERO_URL`. Секреты в этот инструмент передавать нельзя. Ключи провайдеров через шлюз не сохраняются.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://api.tokenzero.sh/mcp`
- Переменные окружения: `TOKENZERO_URL`, `TOKENZERO_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp https://api.tokenzero.sh/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env TOKENZERO_URL=<TOKENZERO_URL> --env TOKENZERO_KEY=<TOKENZERO_KEY> --transport stdio tokenzero -- npx -y @tokenzero/mcp
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add tokenzero --url https://api.tokenzero.sh/mcp
```

2. **Командой платформы**
```bash
codex mcp add tokenzero --env TOKENZERO_URL=<TOKENZERO_URL> --env TOKENZERO_KEY=<TOKENZERO_KEY> -- npx -y @tokenzero/mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tokenzero": {
            "url": "https://api.tokenzero.sh/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tokenzero": {
            "command": "npx",
            "args": [
                "-y",
                "@tokenzero/mcp"
            ],
            "env": {
                "TOKENZERO_URL": "<TOKENZERO_URL>",
                "TOKENZERO_KEY": "<TOKENZERO_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "tokenzero": {
            "type": "http",
            "url": "https://api.tokenzero.sh/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "tokenzero": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@tokenzero/mcp"
            ],
            "env": {
                "TOKENZERO_URL": "<TOKENZERO_URL>",
                "TOKENZERO_KEY": "<TOKENZERO_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http tokenzero https://api.tokenzero.sh/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e TOKENZERO_URL=<TOKENZERO_URL> -e TOKENZERO_KEY=<TOKENZERO_KEY> tokenzero npx -y @tokenzero/mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- найти в коде промпты без кэширования
- сравнить цены альтернативных моделей
- проверить стоимость изменений в pull request
- обнаружить вызовы LLM внутри циклов
- подготовить тело запроса для кэширования

## Примеры запросов агенту
- Проверь репозиторий на потери токенов с помощью `audit_repo_token_waste`.
- Сравни подходящие модели для этого запроса через `calculate_model_arbitrage`.
- Подготовь переданное тело запроса к кэшированию через `optimize_prompt_payload`, не включая секреты.

## Похожие
- [Gonka — Minority report](https://affpapa.org/nevibecode/mcp/gonka-minority-report.md) — MCP-сервер · 431 установка
- [ATOM Pricing Intelligence](https://affpapa.org/nevibecode/mcp/atom-pricing-intelligence.md) — MCP-сервер · 4780 установок
- [caveman-learn](https://affpapa.org/nevibecode/skills/caveman-learn.md) — скилл · 130900 установок
- [hivemind](https://affpapa.org/nevibecode/skills/hivemind.md) — скилл · 4 установки
- [gsd-surface](https://affpapa.org/nevibecode/skills/gsd-surface.md) — скилл · 573 установки
- [efficient-dispatch](https://affpapa.org/nevibecode/skills/efficient-dispatch.md) — скилл · ★ 124 у репозитория

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
