ChatGPT Daily Token Tracker

Инструмент ежедневной статистики токенов для веб-использования ChatGPT, включающий:

• MCP-сервер: можно прямо в ChatGPT спросить «сколько токенов использовано сегодня»;

• Расширение для Edge / Chrome: автоматически перехватывает видимые сообщения пользователя и ответы ассистента на странице chatgpt.com и выполняет оценку токенов локально;

• Автозапуск в Windows: можно использовать фиксированный домен разработки ngrok для предоставления постоянного MCP-адреса и настроить автоматический запуск при включении через планировщик заданий;

• Локальное хранение данных: статистика сохраняется на локальной машине, полный текст переписки не записывается в файлы статистики;

• Механизм дедупликации: обновление страницы и повторное сканирование не приводят к повторному учёту одного и того же сообщения.

[!IMPORTANT] Здесь приведена оценка токенов видимого текста веб-страницы, а не официальный счёт токенов аккаунта OpenAI / ChatGPT. Скрытые системные промпты, внутренние рассуждения, невидимый контекст и т.п. недоступны обычному расширению браузера или MCP.

Возможности

Инструменты MCP

Автоматическая статистика в браузере

После установки расширения новые видимые сообщения ChatGPT автоматически отправляются на:

http://127.0.0.1:8787/api/track-message

Локальный сервис использует токенизатор o200k_base для оценки токенов и сохраняет только статистику: количество токенов, роль, время, ID дедупликации сообщений и т.д.

Расширение также предоставляет функцию «Заполнить текущий диалог»: можно по мере необходимости добавить уже загруженный диалог в статистику текущего дня; одинаковые сообщения автоматически дедуплицируются.

Related MCP server: mcpstat

Требования к окружению

Рекомендуемое окружение:

• Windows 10 / 11

• Node.js 22+

• Microsoft Edge или Google Chrome

• Бесплатный аккаунт ngrok (требуется только для фиксированного публичного MCP-адреса)

• Аккаунт ChatGPT с поддержкой пользовательских MCP / App

Быстрый старт

1. Установка зависимостей

npm install

2. Запуск локального сервиса

В Windows можно запустить двойным щелчком:

启动Token统计插件.bat

Также можно выполнить:

npm start

Адреса по умолчанию:

• MCP: http://127.0.0.1:8787/mcp

• Проверка работоспособности: http://127.0.0.1:8787/health

• Локальный дашборд: http://127.0.0.1:8787/dashboard

3. Установка расширения автоматической статистики для Edge / Chrome

В Windows можно запустить двойным щелчком:

安装浏览器自动统计扩展.bat

Или вручную:

1. В Edge откройте edge://extensions, в Chrome — chrome://extensions;

2. Включите «Режим разработчика»;

3. Нажмите «Загрузить распакованное расширение»;

4. Выберите папку browser-extension в репозитории;

5. Вернитесь на chatgpt.com и обновите страницу.

Всплывающее окно расширения показывает сегодняшние входные и выходные токены, общее количество токенов и число записей.

Фиксированный MCP-адрес + автозапуск Windows

Чтобы ChatGPT мог постоянно подключаться к локальному MCP, нужен публичный HTTPS-адрес. Проект предоставляет скрипт автоматической настройки Windows на основе фиксированного домена разработки ngrok.

Двойным щелчком:

安装长期固定地址并开机自启.bat

Скрипт выполнит следующее:

1. Проверит Node.js и ngrok;

2. Откроет страницу ngrok authtoken в браузере;

3. Попросит вас ввести authtoken в локальном PowerShell;

4. Получит фиксированный домен разработки ngrok, назначенный аккаунту;

5. Создаст локальный config/ngrok.yml;

6. Поместит исполняемую копию ngrok в локальную папку bin/;

7. Создаст задание планировщика Windows ChatGPT-Token-Tracker-Fixed;

8. Автоматически запустит и будет поддерживать работу Node MCP + ngrok;

9. Выведет итоговый фиксированный MCP URL.

Если существующую конфигурацию нужно исправить, выполните:

修复固定地址自启动.bat

Добавление MCP в ChatGPT

На странице пользовательских App / MCP в ChatGPT:

• Server URL: укажите https://xxxxx.ngrok-free.dev/mcp, выведенный скриптом в конце;

• Аутентификация: выберите None / без аутентификации;

• Отсканируйте инструменты и сохраните.

После этого в чате можно вызывать today_usage для получения данных.

Данные и конфиденциальность

Следующее содержимое не отправляется на GitHub:

• data/: локальная статистика токенов, журналы, URL времени выполнения;

• config/: ngrok authtoken и конфигурация запуска;

• bin/: локальный исполняемый файл ngrok;

• .env;

• node_modules/.

Расширение браузера не отправляет полный текст переписки на публичный ngrok-адрес проекта; интерфейс записи автоматической статистики ограничен локальным адресом 127.0.0.1.

[!WARNING] Текущий пример подключения MCP использует «без аутентификации». Фиксированный публичный URL не следует открыто распространять. Для любого публичного сервиса следует добавить аутентификацию, контроль доступа и аудит в соответствии с вашими требованиями к рискам.

Методика учёта токенов

• exact: фактические показатели usage, возвращённые OpenAI API;

• estimated: оценка видимого текста с помощью токенизатора;

• Записи автоматической статистики браузера помечаются как chatgpt-browser-auto + estimated.

Проект не выдаёт оценочные значения за официальные данные биллинга.

Тестирование

npm test

Текущее покрытие тестами включает:

• оценку токенов для китайского и английского текста;

• раздельное суммирование точных и оценочных значений;

• разбивку по дням в Asia/Shanghai;

• дедупликацию по одинаковому eventId;

• запись через HTTP API автоматических записей браузера и их дедупликацию.

Структура проекта

browser-extension/      Edge / Chrome Manifest V3 扩展
src/server.js           MCP + HTTP 服务
src/store.js            本地统计存储与去重
src/tokenizer.js        Token 估算
setup-fixed-ngrok.ps1   固定 ngrok 地址与开机任务安装
run-fixed-supervisor.ps1 Windows 后台守护
repair-fixed-autostart.ps1 固定地址/自启动修复
test/                   自动测试

Разработка и обновление

Рекомендуется после каждого обновления:

npm install
npm test

Если вы изменили src/server.js, пользователи фиксированного развёртывания Windows могут выполнить:

修复固定地址自启动.bat

чтобы фоновая служба SYSTEM перезагрузила новый код.

Лицензия

Лицензия MIT. Подробнее см. LICENSE.