ChatGPT Daily Token Tracker

ChatGPT 웹 사용 시나리오를 위한 일일 Token 통계 도구로, 다음을 포함합니다:

• MCP Server: ChatGPT에서 직접 “오늘 Token을 얼마나 사용했나요?”라고 물어볼 수 있습니다.

• Edge / Chrome 브라우저 확장 프로그램: chatgpt.com 페이지에 표시되는 사용자 메시지와 어시스턴트 응답을 자동으로 캡처하고 로컬에서 Token을 추정합니다.

• Windows 자동 실행: ngrok 고정 개발 도메인으로 장기간 사용할 MCP 주소를 제공하고, 작업 스케줄러를 통해 부팅 시 자동으로 시작할 수 있습니다.

• 로컬 데이터 저장: 통계 데이터는 로컬에 저장되며, 전체 대화 본문은 통계 파일에 기록하지 않습니다.

• 중복 제거 메커니즘: 페이지 새로고침이나 반복 스캔 시 동일한 메시지가 중복 집계되지 않습니다.

[!IMPORTANT] 여기서 통계하는 것은 웹 페이지에 표시되는 텍스트의 Token 추정값이며, OpenAI / ChatGPT 공식 계정 단위 Token 청구서가 아닙니다. 숨겨진 시스템 프롬프트, 내부 추론, 보이지 않는 컨텍스트 등은 일반 웹 확장 프로그램이나 MCP로 얻을 수 없습니다.

기능

MCP 도구

브라우저 자동 통계

확장 프로그램을 설치하면 새로 생성된 ChatGPT 표시 메시지가 자동으로 다음 주소로 전송됩니다:

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

로컬 서비스는 o200k_base tokenizer로 Token을 추정하며, Token 수, 역할, 시간, 메시지 중복 제거 ID 등의 통계 정보만 저장합니다.

확장 프로그램은 또한 “현재 대화 소급 반영” 기능을 제공하여, 필요 시 현재 로드된 대화를 당일 통계에 소급 반영할 수 있습니다. 동일한 메시지는 자동으로 중복 제거됩니다.

Related MCP server: mcpstat

환경 요구 사항

• Windows 10 / 11

• Node.js 22+

• Microsoft Edge 또는 Google Chrome

• 무료 ngrok 계정 (고정 공개 MCP 주소에만 필요)

• 사용자 지정 MCP / App을 지원하는 ChatGPT 계정

빠른 시작

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으로 돌아가 페이지를 새로고침합니다.

확장 프로그램 팝업에는 당일 입력, 출력, 총 Token 및 기록 수가 표시됩니다.

고정 MCP 주소 + Windows 부팅 자동 시작

ChatGPT가 로컬 MCP에 장기간 연결되게 하려면 공개 HTTPS 주소가 필요합니다. 프로젝트는 ngrok 고정 개발 도메인 기반의 Windows 자동 구성 스크립트를 제공합니다.

더블 클릭:

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

스크립트는 다음 작업을 수행합니다:

1. Node.js와 ngrok를 확인합니다.

2. 브라우저에서 ngrok authtoken 페이지를 엽니다.

3. 로컬 PowerShell에서 authtoken을 입력하도록 안내합니다.

4. 계정에 할당된 고정 ngrok 개발 도메인을 가져옵니다.

5. 로컬 config/ngrok.yml을 생성합니다.

6. 실행 가능한 ngrok 복사본을 로컬 bin/에 넣습니다.

7. Windows 작업 스케줄러 작업 ChatGPT-Token-Tracker-Fixed를 생성합니다.

8. Node MCP + ngrok를 자동으로 시작하고 백그라운드에서 유지합니다.

9. 최종 고정 MCP URL을 출력합니다.

기존 구성에 수정이 필요하면 다음을 실행할 수 있습니다:

修复固定地址自启动.bat

ChatGPT에 MCP 추가

ChatGPT의 사용자 지정 App / MCP 페이지에서:

• Server URL: 스크립트가 마지막에 출력한 https://xxxxx.ngrok-free.dev/mcp를 입력합니다.

• 인증: None / 인증 없음을 선택합니다.

• 도구를 스캔하고 저장합니다.

이후 채팅에서 today_usage를 호출하여 조회할 수 있습니다.

데이터 및 개인정보 보호

다음 내용은 GitHub에 커밋되지 않습니다:

• data/: 로컬 Token 통계, 로그, 런타임 URL

• config/: ngrok authtoken 및 실행 구성

• bin/: 로컬 ngrok 실행 파일

• .env

• node_modules/

브라우저 확장 프로그램은 전체 대화 본문을 프로젝트의 공개 ngrok 주소로 전송하지 않습니다. 자동 통계 기록 인터페스는 로컬 127.0.0.1로 제한됩니다.

[!WARNING] 현재 MCP 연결 예시는 “인증 없음”을 사용합니다. 고정 공개 URL은 임의로 공유해서는 안 됩니다. 모든 공개 서비스는 자신의 위험 요구에 따라 인증, 접근 제어 및 감사를 추가해야 합니다.

Token 통계 기준

• exact: OpenAI API에서 이미 반환된 실제 usage 수치

• estimated: tokenizer를 사용하여 표시 텍스트를 추정

• 브라우저 자동 통계 기록은 chatgpt-browser-auto + estimated로 표시됩니다.

프로젝트는 추정값을 공식 과금 데이터로 가장하지 않습니다.

테스트

npm test

현재 테스트는 다음을 포함합니다:

• 중문/영문 Token 추정

• 정확값과 추정값을 분리하여 집계

• 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 서비스가 새 코드를 다시 로드하게 합니다.

License

MIT License. 자세한 내용은 LICENSE를 참고하세요.