Claude Code History

Servidor MCP de Histórico do Claude Code

Um servidor MCP para recuperar e analisar o histórico de conversas do Claude Code com filtragem inteligente e paginação.

Recursos

Este servidor MCP fornece 4 ferramentas poderosas para explorar o seu histórico de conversas do Claude Code:

1. list_projects 👀 Comece Aqui

Descubra todos os projetos com histórico de conversas do Claude Code.

Por que usar primeiro: Obtenha uma visão geral de todos os dados disponíveis antes de se aprofundar.

Retorna: Caminhos de projetos, contagens de sessões, contagens de mensagens e horário da última atividade.

2. list_sessions 📁 Explorar Sessões

Liste sessões de conversa para exploração e filtragem.

Parâmetros:

• projectPath (opcional): Filtrar por projeto específico
• startDate (opcional): Data de início (ex.: "2025-06-30")
• endDate (opcional): Data de término (ex.: "2025-06-30")
• timezone (opcional): Fuso horário para filtragem por data (ex.: "Asia/Tokyo", "UTC")

Retorna: IDs de sessão, carimbos de data/hora, contagens de mensagens e caminhos de projetos.

3. get_conversation_history 💬 Obter Dados Detalhados

Recupere o histórico de conversas paginado com filtragem inteligente.

Principais recursos:

• Paginação: limit (padrão: 20) e offset para manipulação eficiente de dados
• Filtragem de Mensagens: messageTypes padrão para ["user"] para reduzir o volume de dados
• Suporte a Fuso Horário: Detecção automática de fuso horário ou especifique (ex.: "Asia/Tokyo")
• Filtragem por Data: Normalização inteligente de datas com consciência de fuso horário

Parâmetros:

• sessionId (opcional): ID de sessão específico
• startDate (opcional): Data de início (ex.: "2025-06-30")
• endDate (opcional): Data de término (ex.: "2025-06-30")
• limit (opcional): Máximo de entradas por página (padrão: 20)
• offset (opcional): Pular entradas para paginação (padrão: 0)
• messageTypes (opcional): ["user"] (padrão), ["user", "assistant"], etc.
• timezone (opcional): ex.: "Asia/Tokyo", "UTC" (detectado automaticamente)

Exemplo:

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

A resposta inclui informações de paginação:

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

4. search_conversations 🔍 Encontrar Conteúdo Específico

Pesquise em todo o conteúdo das conversas por palavras-chave com filtragem avançada.

Parâmetros:

• query (obrigatório): Termos de pesquisa
• limit (opcional): Máximo de resultados (padrão: 30)
• projectPath (opcional): Filtrar por caminho de projeto específico
• startDate (opcional): Data de início (ex.: "2025-06-30")
• endDate (opcional): Data de término (ex.: "2025-06-30")
• timezone (opcional): Fuso horário para filtragem por data (ex.: "Asia/Tokyo", "UTC")

Início 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 com Clientes MCP

Adicione a seguinte configuração ao seu cliente MCP (ex.: Claude Desktop):

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

Alternativamente, se você instalou o pacote globalmente:

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

Fluxo de Trabalho Recomendado 🚀

1. Explore os Dados Disponíveis

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

2. Encontre Sessões 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. Obtenha Dados Direcionados

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

Fonte de Dados

Este servidor lê arquivos de histórico do Claude Code (formato .jsonl) armazenados em ~/.claude/projects/.

Recursos Inteligentes 💡

Filtragem por Tipo de Mensagem

• Padrão: Apenas mensagens ["user"] para reduzir o volume de dados
• Conversa completa: Use ["user", "assistant"]
• Tudo: Use ["user", "assistant", "system", "result"]

Inteligência de Fuso Horário

• Detecta automaticamente o fuso horário do seu sistema
• Suporta especificação explícita de fuso horário (ex.: "Asia/Tokyo")
• Normalização inteligente de datas (ex.: "2025-06-30" → limites de fuso horário adequados)

Suporte a Paginação

• Manipulação eficiente de grandes conjuntos de dados
• total_count ajuda você a entender o volume de dados
• has_more indica se há dados adicionais

Casos de Uso

Revisão Diária de Trabalho

What did I work on today?

1. list_projects → Veja projetos ativos
2. get_conversation_history com a data de hoje e messageTypes: ["user"]

Mergulho Profundo em Projetos

Analyze my recent work on Project X

1. list_sessions com caminho de projeto específico
2. get_conversation_history para sessões relevantes
3. Use a paginação para navegar por todos os dados

Pesquisa de Tópicos

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

1. search_conversations com consulta "API integration", projectPath e intervalo de datas
2. Use os resultados para identificar sessões relevantes
3. get_conversation_history para contexto detalhado

Exemplo com filtragem avançada:

{
  "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
}

Licença

MIT