Tiktoken MCP

Cuenta tokens usando la librería tiktoken de OpenAI.

Documentación

tiktoken-mcp

Un servidor MCP (Model Context Protocol) que proporciona funcionalidad de conteo de tokens utilizando la librería tiktoken de OpenAI.

Características

  • 🔢 Conteo de Tokens: Cuenta tokens para cualquier texto usando varias codificaciones de tiktoken
  • 💰 Estimación de Costos: Estima costos de tokens para modelos de IA populares (GPT-4, Claude, etc.)
  • 🚀 Fácil de Usar: Ejecútalo directamente con npx - no requiere instalación
  • 🔧 Integración con Claude Desktop: Se integra perfectamente con la aplicación Claude Desktop

Instalación

Puedes ejecutar este servidor MCP directamente usando npx:

npx tiktoken-mcp

O instálalo globalmente:

npm install -g tiktoken-mcp

Requisitos Previos

  • Node.js 16 o superior
  • Python 3.6 o superior
  • pip (gestor de paquetes de Python)

La librería tiktoken de Python se instalará automáticamente la primera vez que ejecutes el paquete.

Herramientas Disponibles

count_tokens

Cuenta tokens en texto usando varias codificaciones de tiktoken.

Parámetros:

  • text (obligatorio): El texto para contar tokens
  • model (opcional): El modelo de codificación a usar. Opciones: 'cl100k_base' (predeterminado), 'p50k_base', 'p50k_edit', 'r50k_base'

estimate_cost

Estima costos de tokens para varios modelos de IA.

Parámetros:

  • text (obligatorio): El texto para estimar el costo
  • model (obligatorio): El modelo para estimar el costo. Opciones: 'gpt-4', 'gpt-4-turbo', 'gpt-3.5-turbo', 'claude-3-opus', 'claude-3-sonnet', 'claude-3-haiku'

Configuración de Claude Desktop

Para usar este servidor MCP con Claude Desktop, agrega lo siguiente a tu archivo de configuración de Claude:

macOS

Ubicación: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Ubicación: %APPDATA%\Claude\claude_desktop_config.json

Configuración

{
  "mcpServers": {
    "tiktoken": {
      "command": "npx",
      "args": ["tiktoken-mcp"]
    }
  }
}

Después de agregar esta configuración, reinicia Claude Desktop. Deberías poder usar las herramientas de conteo de tokens en tus conversaciones.

Ejemplo de Uso en Claude

Una vez configurado, puedes usar las herramientas de esta manera:

  • "Cuenta los tokens en este texto: '¡Hola, mundo!'"
  • "Estima el costo de este prompt para GPT-4"
  • "¿Cuántos tokens hay en este párrafo usando la codificación cl100k_base?"

Ejemplo de Salida

Conteo de Tokens:

Token count: 13
Model: cl100k_base
First 100 token IDs: 9906, 11, 1917, 0, 498, 1097, 701, 30, 220, 17, ...

Estimación de Costos:

Token count: 150
Model: gpt-4
Estimated input cost: $0.004500
Estimated output cost: $0.009000
Total cost (if used as both input and output): $0.013500

Cómo Funciona

Este servidor MCP utiliza la librería tiktoken de Python internamente para contar tokens con precisión. Soporta múltiples modelos de codificación:

  • cl100k_base: Usado por GPT-4, GPT-3.5-turbo y modelos más nuevos
  • p50k_base: Usado por modelos Codex
  • p50k_edit: Usado por modelos de edición
  • r50k_base: Usado por modelos GPT-3

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

Problemas

Si encuentras algún problema, por favor reporta un issue en el repositorio de GitHub.

Licencia

MIT