Do Zero à Integração: Tutorial Definitivo para Passage-of-Time-MCP e Claude
O passage-of-time-mcp é um servidor MCP que concede aos modelos de linguagem uma consciência temporal e habilidades de cálculo de tempo. Este tutorial detalha como integrar o passage-of-time-mcp com o Claude, conferindo ao AI uma potente capacidade de processamento temporal.
Passos Iniciais: Instalação Rápida do Passage-of-Time-MCP
Antes de iniciar a integração, instale o passage-of-time-mcp. Certifique-se de que seu sistema possui Python e Git instalados, em seguida execute os comandos abaixo:
git clone https://gitcode.com/gh_mirrors/pa/passage-of-time-mcp
cd passage-of-time-mcp
pipenv install
pipenv shell
python temporal_mcp.py
Após a execução bem-sucedida, o servidor será iniciado na porta local 8000, fornecendo suporte em tempo real para o Claude.
Passo a Passo: Guia Detalhado para Integração com o Claude
Obter Endereço do Servidor
Quando o passage-of-time-mcp está em execução, você precisará obter o endereço de acesso. Para execuções locais, o endereço padrão geralmente é http://localhost:8000/sse. Para acessos externos, talvez seja necessário usar ferramentas como ngrok, conforme exemplo a seguir:
Adicionando uma Integração Personalizada no Claude
- Abra o Claude e vá para a opção Integrações
- Clique em + Adicionar Integração
- Selecione o tipo Personalizado
- Digite o nome "Tempo do Passar" e insira o endereço do servidor
Após a adição, você verá a integração temporal-mcp na lista de integrações:
Configuração de Permissões: Ferramentas de Tempo
Após a integração, configure as permissões para as ferramentas de tempo específicas. No painel de configurações do Claude, você encontrará todas as ferramentas fornecidas pelo passage-of-time-mcp:
Certifique-se de que as ferramentas a seguir estão habilitadas:
current_datetime: Obter data e hora atuaistime_difference: Calcular diferença entre timestampstime_since: Calcular tempo decorridoparse_timestamp: Analisar e converter timestampsadd_time: Adicionar/subtrair duração de tempo
Demonstração de Funcionalidades: Experimentando o Processamento Temporal
Após a integração, o Claude adquire habilidades avançadas de processamento temporal. Na interface de chat, você pode acessar as ferramentas de tempo através do ícone de ferramentas:
Exemplos Práticos
- Obter Hora Atual: Pergunte "Qual é a hora atual?" e o Claude usará a ferramenta
current_datetime - Cálculo de Diferença de Tempo: Pergunte "Quanto tempo dura entre 2024-01-01 e 2024-12-31?" e o Claude usará
time_difference - Tempo decorrido: Pergunte "Quanto tempo falta para os Jogos Olímpicos de 2024?" e o Claude usará
time_since - Conversão de Timestamp: Peça "Converta 2024-07-25 15:30:00 para timestamp Unix" e o Claude usará
parse_timestamp
Soluções para Problemas Comuns
Conexão Falhando?
Se o Claude não conseguir se conectar ao servidor passage-of-time-mcp, verifique:
- Se o servidor está rodando
- Se o endereço está correto (especialmente com ngrok)
- Se o firewall permite conexões
Resultados de Tempo Inconsistentes?
Os resultados dependem da configuração de fusos horários. O passage-of-time-mcp usa America/New_York por padrão. Você pode指定 outros fusos horários como:
current_datetime(timezone="Asia/Shanghai")
Quais Formatos de Tempo São Suportados?
Todos os tools suportam os seguintes formatos:
- Timestamp Completo: "YYYY-MM-DD HH:MM:SS" (Ex: 2024-07-25 14:30:00)
- Somente Data: "YYYY-MM-DD" (Ex: 2024-07-25)
Conclusão: Despertando a Inteligência Temporal do Claude
A integração do passage-of-time-mcp transforma o Claude de uma simples ferramenta de IA em um sistema capaz de processar tarefas temporais com precisão. Seja para agendamento, análise histórica ou planejamento futuro, essa integração concede ao Claude uma habilidade cognitiva robusta em torno do tempo.
Agora que você domina os passos para integrar o passage-of-time-mcp com o Claude, experimente a potência do processamento temporal e eleve a capacidade do seu sistema de IA!