Temporal-MCP: Consciência de Relógio de Parede para LLMs com Suporte a OAuth

Temporal-MCP é um novo servidor MCP projetado para resolver um modo de falha comum em pilhas de agentes: o modelo não tem noção de quanto tempo passou entre interações. Ele te cumprimenta com 'bom dia' às 23h, retoma uma conversa três semanas depois como se nenhum tempo tivesse passado, ou calcula 'dados de hoje' com base em contexto desatualizado. Duas ferramentas são fornecidas: temporal_tick e temporal_peek. Elas retornam o tempo decorrido desde a última interação, detecção de virada de dia e um sinalizador de nova conversa, tanto como um cabeçalho legível quanto como JSON.

Configuração e Uso

Stdio local: pip install temporal-mcp (funciona com Claude Desktop, Cursor, Cline, Zed, Claude Code).

Hospedado com OAuth (claude.ai / ChatGPT): visite https://temporal-mcp.dev/connect, clique em 'Gerar Credenciais OAuth' e cole no seu conector personalizado. OAuth 2.0 completo com PKCE e tokens de atualização. Nenhum cadastro necessário — o par de credenciais é a identidade. Verificado funcionando no claude.ai.

Hospedado com bearer simples (qualquer cliente que suporte cabeçalhos personalizados): use Authorization: Bearer <qualquer-string-opaca> contra https://temporal-mcp.dev/mcp. O token é hash SHA-256; o servidor nunca vê o texto simples.

Auto-hospedado: implantação Cloudflare Workers usando o diretório workers/ no repositório. O nível gratuito cobre ~100k requisições/dia.

Grok/xAI: https://temporal-mcp.dev/mcp/<string> (verificado funcionando no Grok).

Detalhes de Implementação

Licenciado sob MIT. ~150 linhas de Python stdlib no lado local, ~400 linhas de TypeScript no lado hospedado (motor + provedor OAuth), ambos com testes. Listado no Registro Oficial MCP. Submissões para Smithery e Glama estão em andamento.

Os sinais JSON day_rollover e delta_sec podem ser usados para decaimento de contexto e detecção de retomada, entre outros casos de uso.

Fonte: github.com/MirrorEthic/temporal-mcp