Time MCP Server

Time MCP Server

Um servidor Model Context Protocol que fornece capacidades relacionadas a tempo. Este servidor permite que LLMs acessem informações de horário atual e convertam horários entre diferentes fusos horários. Esta é uma implementação Swift de um servidor MCP de tempo usando o MCP Swift SDK.

✨ Recursos

• Consultas de Horário Atual: Obtenha o horário atual em qualquer fuso horário
• Conversões de Fuso Horário: Converta horários entre diferentes fusos horários
• Informações de Horário de Verão: Verifique se um fuso horário está atualmente em horário de verão (DST)
• Cálculo de Diferença de Horário: Obtenha a diferença de horário entre fusos horários ao converter

Ferramentas Disponíveis

• get_current_time - Obtenha o horário atual em um fuso horário específico

  • timezone (string, obrigatório): Nome do fuso horário IANA (ex.: 'America/New_York', 'Europe/London'). Se vazio ou não fornecido, o fuso horário do sistema será usado.

• convert_time - Converta horários entre fusos horários

  • source_timezone (string, obrigatório): Nome do fuso horário IANA de origem. Se vazio ou não fornecido, o fuso horário do sistema será usado.
  • time (string, obrigatório): Horário a ser convertido no formato 24 horas (HH:MM)
  • target_timezone (string, obrigatório): Nome do fuso horário IANA de destino. Se vazio ou não fornecido, o fuso horário do sistema será usado.

Instalação

Opção 1: Instalação em Uma Linha (curl)

A maneira mais fácil de instalar é com o instalador de uma linha, que baixa automaticamente a versão mais recente e a instala em ~/.local/bin no seu diretório pessoal:

curl -fsSL https://raw.githubusercontent.com/okooo5km/time-mcp-server/main/install.sh | bash

O instalador irá:

• Criar ~/.local/bin se não existir
• Adicionar este diretório ao seu PATH (em .zshrc ou .bashrc)
• Baixar e instalar a versão mais recente
• Tornar o binário executável

Opção 2: Compilar a partir do Código Fonte

1. Clone o repositório:

   git clone https://github.com/okooo5km/time-mcp-server.git
   cd time-mcp-server
   

2. Compile o projeto:

   swift build -c release
   

3. Instale o binário:

   # Install to user directory (recommended, no sudo required)
   mkdir -p ~/.local/bin
   cp $(swift build -c release --show-bin-path)/time-mcp-server ~/.local/bin/
   

   Certifique-se de que ~/.local/bin esteja no seu PATH adicionando ao seu arquivo de configuração do shell:

   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc  # or ~/.bashrc
   source ~/.zshrc  # or source ~/.bashrc
   

Argumentos de Linha de Comando

O servidor suporta os seguintes argumentos de linha de comando:

• -h, --help: Exibe informações de ajuda sobre o servidor, seu uso e opções disponíveis
• -v, --version: Exibe o número da versão do time-mcp-server

Exemplo de uso:

# Display help information
time-mcp-server --help

# Display version information
time-mcp-server --version

Configurar para Claude.app

Adicione às suas configurações do Claude:

"mcpServers": {
  "RealTime": {
    "command": "time-mcp-server"
  }
}

Configurar para Cursor

Adicione a seguinte configuração ao Settings - mcp.json do seu editor Cursor:

{
  "mcpServers": {
    "RealTime": {
      "command": "time-mcp-server"
    }
  }
}

Configurar para ChatWise

Adicione o servidor MCP de memória ao seu Chatwise Settings - Tools.

Exemplo de Prompt de Sistema

Você pode usar o seguinte prompt de sistema para ajudar o Claude a utilizar o time-mcp-server de forma eficaz:

You have access to time-related tools through MCP. Use these to help users:

- Get the current time in any timezone
- Convert times between timezones
- Calculate time differences between locations
- Plan meetings across different timezones

Use the following tools appropriately:
- `get_current_time` for checking the current time in a specific timezone
- `convert_time` when the user needs to convert between timezones

Always use proper IANA timezone names (e.g., 'America/New_York', 'Europe/London', 'Asia/Tokyo') 
rather than abbreviations or common names.

Requisitos de Desenvolvimento

• Swift 6.0 ou posterior
• macOS 14.0 ou posterior
• MCP Swift SDK 0.2.0 ou posterior

Exemplos de Uso

Obtendo o Horário Atual

{
  "timezone": "America/New_York"
}

Resposta:

{
  "timezone": "America/New_York",
  "datetime": "2024-11-05T14:30:45-05:00",
  "is_dst": false
}

Convertendo Horário

{
  "source_timezone": "America/Los_Angeles",
  "time": "15:30",
  "target_timezone": "Asia/Tokyo"
}

Resposta:

{
  "source": {
    "timezone": "America/Los_Angeles",
    "datetime": "2024-11-05T15:30:00-08:00",
    "is_dst": false
  },
  "target": {
    "timezone": "Asia/Tokyo",
    "datetime": "2024-11-06T08:30:00+09:00",
    "is_dst": false
  },
  "time_difference": "+17h"
}

Casos de Uso

• Planejamento de Reuniões Internacionais: Agende reuniões em diferentes fusos horários
• Planejamento de Viagens: Verifique os horários locais no destino
• Coordenação de Trabalho Remoto: Coordene horários de trabalho com equipes internacionais
• Agendamento de Eventos: Configure eventos globais com horários locais corretos
• Operações Sensíveis ao Tempo: Garanta que as operações aconteçam no horário local correto

Histórico de Versões

Consulte os Releases do GitHub para o histórico de versões e changelog.

☕️ Apoie o Projeto

Se você acha o time-mcp-server útil, considere apoiar seu desenvolvimento:

• ⭐️ Dê uma estrela no projeto no GitHub
• 🐛 Reporte bugs ou sugira recursos
• 💝 Apoie via:

Licença

time-mcp-server é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT.

Sobre

Uma implementação Swift de um servidor de tempo para Model Context Protocol (MCP), permitindo que assistentes de IA acessem informações de horário atual e convertam entre fusos horários. Este projeto é construído usando o MCP Swift SDK.