Claude Code History

Servidor MCP de Historial de Claude Code

Un servidor MCP para recuperar y analizar el historial de conversaciones de Claude Code con filtrado inteligente y paginación.

Características

Este servidor MCP proporciona 4 herramientas potentes para explorar tu historial de conversaciones de Claude Code:

1. list_projects 👀 Comienza aquí

Descubre todos los proyectos con historial de conversaciones de Claude Code.

Por qué usarlo primero: Obtén una visión general de todos los datos disponibles antes de profundizar.

Devuelve: Rutas de proyectos, recuentos de sesiones, recuentos de mensajes y hora de la última actividad.

2. list_sessions 📁 Explorar sesiones

Lista sesiones de conversación para exploración y filtrado.

Parámetros:

• projectPath (opcional): Filtrar por proyecto específico
• startDate (opcional): Fecha de inicio (p. ej., "2025-06-30")
• endDate (opcional): Fecha de fin (p. ej., "2025-06-30")
• timezone (opcional): Zona horaria para el filtrado por fecha (p. ej., "Asia/Tokyo", "UTC")

Devuelve: IDs de sesión, marcas de tiempo, recuentos de mensajes y rutas de proyectos.

3. get_conversation_history 💬 Obtener datos detallados

Recupera el historial de conversaciones paginado con filtrado inteligente.

Características clave:

• Paginación: limit (predeterminado: 20) y offset para un manejo eficiente de datos
• Filtrado de mensajes: messageTypes por defecto es ["user"] para reducir el volumen de datos
• Soporte de zona horaria: Detección automática de zona horaria o especificación manual (p. ej., "Asia/Tokyo")
• Filtrado por fecha: Normalización inteligente de fechas con conocimiento de zona horaria

Parámetros:

• sessionId (opcional): ID de sesión específico
• startDate (opcional): Fecha de inicio (p. ej., "2025-06-30")
• endDate (opcional): Fecha de fin (p. ej., "2025-06-30")
• limit (opcional): Máximo de entradas por página (predeterminado: 20)
• offset (opcional): Omitir entradas para paginación (predeterminado: 0)
• messageTypes (opcional): ["user"] (predeterminado), ["user", "assistant"], etc.
• timezone (opcional): p. ej., "Asia/Tokyo", "UTC" (detección automática)

Ejemplo:

{
  "startDate": "2025-06-30",
  "limit": 50,
  "messageTypes": ["user"],
  "timezone": "Asia/Tokyo"
}

La respuesta incluye información de paginación:

{
  "entries": [...],
  "pagination": {
    "total_count": 150,
    "limit": 20,
    "offset": 0,
    "has_more": true
  }
}

4. search_conversations 🔍 Buscar contenido específico

Busca en todo el contenido de conversaciones por palabras clave con filtrado avanzado.

Parámetros:

• query (obligatorio): Términos de búsqueda
• limit (opcional): Máximo de resultados (predeterminado: 30)
• projectPath (opcional): Filtrar por ruta de proyecto específica
• startDate (opcional): Fecha de inicio (p. ej., "2025-06-30")
• endDate (opcional): Fecha de fin (p. ej., "2025-06-30")
• timezone (opcional): Zona horaria para el filtrado por fecha (p. ej., "Asia/Tokyo", "UTC")

Inicio rápido

# Install directly via npx (no local installation needed)
npx claude-code-history-mcp

# Or install globally
npm install -g claude-code-history-mcp

Uso con clientes MCP

Agrega la siguiente configuración a tu cliente MCP (p. ej., Claude Desktop):

{
  "mcpServers": {
    "claude-code-history": {
      "command": "npx",
      "args": ["claude-code-history-mcp"]
    }
  }
}

Alternativamente, si has instalado el paquete globalmente:

{
  "mcpServers": {
    "claude-code-history": {
      "command": "claude-code-history-mcp"
    }
  }
}

Flujo de trabajo recomendado 🚀

1. Explorar datos disponibles

// Start with list_projects to see what's available
{"tool": "list_projects"}

2. Encontrar sesiones relevantes

// List sessions for a specific project or date range with timezone
{
  "tool": "list_sessions",
  "projectPath": "/Users/yourname/code/my-project",
  "startDate": "2025-06-30",
  "timezone": "Asia/Tokyo"
}

3. Obtener datos específicos

// Get conversation history with optimal settings
{
  "tool": "get_conversation_history", 
  "sessionId": "specific-session-id",
  "messageTypes": ["user"],  // Only your inputs (default)
  "limit": 50
}

Fuente de datos

Este servidor lee archivos de historial de Claude Code (formato .jsonl) almacenados en ~/.claude/projects/.

Características inteligentes 💡

Filtrado por tipo de mensaje

• Predeterminado: Solo mensajes ["user"] para reducir el volumen de datos
• Conversación completa: Usa ["user", "assistant"]
• Todo: Usa ["user", "assistant", "system", "result"]

Inteligencia de zona horaria

• Detecta automáticamente la zona horaria de tu sistema
• Admite especificación explícita de zona horaria (p. ej., "Asia/Tokyo")
• Normalización inteligente de fechas (p. ej., "2025-06-30" → límites de zona horaria adecuados)

Soporte de paginación

• Manejo eficiente de conjuntos de datos grandes
• total_count te ayuda a comprender el volumen de datos
• has_more indica si hay datos adicionales

Casos de uso

Revisión diaria de trabajo

What did I work on today?

1. list_projects → Ver proyectos activos
2. get_conversation_history con la fecha de hoy y messageTypes: ["user"]

Inmersión profunda en proyectos

Analyze my recent work on Project X

1. list_sessions con la ruta de proyecto específica
2. get_conversation_history para sesiones relevantes
3. Usa la paginación para navegar por todos los datos

Investigación de temas

Find all conversations about "API integration" in a specific project

1. search_conversations con la consulta "integración de API", projectPath y rango de fechas
2. Usa los resultados para identificar sesiones relevantes
3. get_conversation_history para contexto detallado

Ejemplo con filtrado avanzado:

{
  "tool": "search_conversations",
  "query": "API integration",
  "projectPath": "/Users/yourname/code/my-project",
  "startDate": "2025-06-01",
  "endDate": "2025-06-30",
  "timezone": "Asia/Tokyo",
  "limit": 50
}

Licencia

MIT