wn01011/llm-token-tracker

wn01011/llm-token-tracker

от wn01011
MCP сервер для автоматического отслеживания токенов и стоимости API OpenAI, Claude и Gemini. Помогает разработчикам интегрировать учёт затрат в свои приложения и передавать точные данные пользовате...

LLM Token Tracker 🧮

Token usage tracker for OpenAI, Claude, and Gemini APIs with MCP (Model Context Protocol) support. Pass accurate API costs to your users.

npm version License: MIT

llm-token-tracker MCP server

✨ Features

  • 🎯 Simple Integration - One line to wrap your API client
  • 📊 Automatic Tracking - No manual token counting
  • 💰 Accurate Pricing - Up-to-date pricing for all models (2025)
  • 🔄 Multiple Providers - OpenAI, Claude, and Gemini support
  • 📈 User Management - Track usage per user/session
  • 🌐 Currency Support - USD and KRW
  • 🤖 MCP Server - Use directly in Claude Desktop!
  • 🆕 Intuitive Session Tracking - Real-time usage with progress bars

📦 Installation

npm install llm-token-tracker

🚀 Quick Start

Option 1: Use as Library
const { TokenTracker } = require('llm-token-tracker');
// or import { TokenTracker } from 'llm-token-tracker';

// Initialize tracker
const tracker = new TokenTracker({
  currency: 'USD' // or 'KRW'
});

// Example: Manual tracking
const trackingId = tracker.startTracking('user-123');

// ... your API call here ...

tracker.endTracking(trackingId, {
  provider: 'openai', // or 'anthropic' or 'gemini'
  model: 'gpt-3.5-turbo',
  inputTokens: 100,
  outputTokens: 50,
  totalTokens: 150
});

// Get user's usage
const usage = tracker.getUserUsage('user-123');
console.log(`Total cost: $${usage.totalCost}`);

Часто задаваемые вопросы

Инструменты были проиндексированы:
clear_usage

Очистить данные использования

Параметры
  • user_idstringобязательный

    Идентификатор пользователя для очистки.

compare_costs

Сравнивает стоимость между моделями

Параметры
  • tokensnumberобязательный

    Количество токенов для сравнения

get_current_session

Получает текущее использование сессии в интуитивно понятном формате (оставшиеся, использованные, токены ввода/вывода, стоимость).

Параметры
  • total_budgetnumber

    Общий бюджет токенов (необязательно)

  • user_idstring

    User ID (по умолчанию: текущая сессия)

get_exchange_rate

Получает текущий курс USD к KRW с информацией о кэше.

Параметры
  • force_refreshboolean

    Принудительно обновляет из API (по умолчанию: false)

get_usage

Получает сводку использования.

Параметры
  • user_idstring

    ID пользователя (необязательно)

track_usage

Отслеживает использование токенов для вызова AI API

Параметры
  • input_tokensnumberобязательный

    Использовано входных токенов.

  • modelstringобязательный

    Название модели

  • output_tokensnumberобязательный

    Использовано выходных токенов

  • providerenumобязательный

    ИИ-провайдер.

  • user_idstring

    Необязательный ID пользователя.

2.4.0основная
2.3.3
2.3.2
2.3.1
2.3.0
2.2.0
2.1.0
2.0.1
2.0.0
1.1.0
1.0.0

Выберите клиент, чтобы установить wn01011/llm-token-tracker:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "wn01011-llm-token-tracker-e2i9mf5vc1": {
      "args": [
        "llm-token-tracker"
      ],
      "command": "npx"
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "wn01011-llm-token-tracker-e2i9mf5vc1": {
      "args": [
        "llm-token-tracker"
      ],
      "command": "npx"
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "wn01011-llm-token-tracker-e2i9mf5vc1": {
      "type": "stdio",
      "args": [
        "llm-token-tracker"
      ],
      "command": "npx"
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"wn01011-llm-token-tracker-e2i9mf5vc1\",\"type\":\"stdio\",\"args\":[\"llm-token-tracker\"],\"command\":\"npx\"}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "wn01011-llm-token-tracker-e2i9mf5vc1": {
      "args": [
        "llm-token-tracker"
      ],
      "command": "npx"
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add wn01011-llm-token-tracker-e2i9mf5vc1 -- npx llm-token-tracker

Либо через JSON-конфиг:

claude mcp add-json wn01011-llm-token-tracker-e2i9mf5vc1 "{\"args\":[\"llm-token-tracker\"],\"command\":\"npx\"}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add wn01011-llm-token-tracker-e2i9mf5vc1 -- npx llm-token-tracker

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.wn01011-llm-token-tracker-e2i9mf5vc1]
command = "npx"
args = ["llm-token-tracker"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите wn01011/llm-token-tracker, а в поле команды запуска — строку ниже:
npx llm-token-tracker

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "wn01011-llm-token-tracker-e2i9mf5vc1": {
      "args": [
        "llm-token-tracker"
      ],
      "command": "npx"
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "wn01011-llm-token-tracker-e2i9mf5vc1": {
      "args": [
        "llm-token-tracker"
      ],
      "command": "npx",
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например wn01011-llm-token-tracker-e2i9mf5vc1.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: wn01011-llm-token-tracker-e2i9mf5vc1
    command: npx
    args:
      - "llm-token-tracker"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "wn01011-llm-token-tracker-e2i9mf5vc1": {
      "args": [
        "llm-token-tracker"
      ],
      "command": "npx"
    }
  }
}

Похожие MCP-сервера

aashari/mcp-server-atlassian-jira

aashari/mcp-server-atlassian-jira

от aashari

Подключает AI-ассистентов к Jira: запрашивайте проекты, задачи, комментарии на естественном языке. Упрощает управление проектами и отслеживание работы для разработчиков, менеджеров и всех пользоват...

TypeScript⭐ 77
kimtth/mcp-aoai-web-browsing

kimtth/mcp-aoai-web-browsing

от kimtth

Сервер MCP для браузерной автоматизации через Playwright, интегрированный с Azure OpenAI и OpenAI. Преобразует инструменты MCP в вызовы функций OpenAI, позволяя AI-агентам управлять веб-страницами....

Python⭐ 35
whdrnr2583-cmd/token-meter

whdrnr2583-cmd/token-meter

от whdrnr2583-cmd

MCP сервер для локального отслеживания токенов и стоимости Claude Code, Codex и Cursor. Анализирует JSONL файлы и показывает разбивку по проектам, моделям и MCP инструментам — без отправки данных в облако и без аккаунта.

TypeScript⭐ 1
jasonwilbur/oci-pricing-mcp

jasonwilbur/oci-pricing-mcp

от jasonwilbur

Этот MCP инструмент даёт AI-ассистентам данные о ценах Oracle Cloud. Сервер позволяет сравнивать стоимость ресурсов (VM, хранилища, БД), оценивать ежемесячные расходы и находить оптимальные конфигурации. Полезен DevOps и архитекторам для оптимизации затрат на OCI.

TypeScript⭐ 5
СДЭК MCP

СДЭК MCP

от theyahia

MCP сервер для работы с API СДЭК: 16 инструментов для расчета тарифов, управления заказами и отслеживания отправлений. Автоматизирует логистику в AI-ассистентах - от стоимости доставки до вызова курьера и печати квитанций.

TypeScript⭐ 1
pminervini/deep-research-mcp

pminervini/deep-research-mcp

от pminervini

MCP-сервер для глубоких исследований с поддержкой OpenAI, Gemini и DR-Tulu. Включает систему уточнения запросов, длительные задачи и интеграцию с Claude Code. Помогает автоматизировать сбор данных.

Python⭐ 115
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин