Time

Servidor MCP Time

Um servidor Model Context Protocol que fornece capacidades de conversão de hora e fuso horário. Este servidor permite que LLMs obtenham informações de hora atual e realizem conversões de fuso horário usando nomes de fusos horários IANA, com detecção automática do fuso horário do sistema.

Ferramentas Disponíveis

• get_current_time - Obtém a hora atual em um fuso horário específico ou no fuso horário do sistema.

  • Argumentos obrigatórios:
    • timezone (string): Nome do fuso horário IANA (ex.: 'America/New_York', 'Europe/London')

• convert_time - Converte hora entre fusos horários.

  • Argumentos obrigatórios:
    • source_timezone (string): Nome do fuso horário IANA de origem
    • time (string): Hora no formato 24 horas (HH:MM)
    • target_timezone (string): Nome do fuso horário IANA de destino

Instalação

Usando uv (recomendado)

Ao usar uv, nenhuma instalação específica é necessária. Usaremos uvx para executar diretamente o mcp-server-time.

Usando PIP

Alternativamente, você pode instalar o mcp-server-time via pip:

pip install mcp-server-time

Após a instalação, você pode executá-lo como um script usando:

python -m mcp_server_time

Configuração

Configurar para Claude.app

Adicione às suas configurações do Claude:

"mcpServers": {
  "time": {
    "command": "uvx",
    "args": ["mcp-server-time"]
  }
}

"mcpServers": {
  "time": {
    "command": "docker",
    "args": ["run", "-i", "--rm", "mcp/time"]
  }
}

"mcpServers": {
  "time": {
    "command": "python",
    "args": ["-m", "mcp_server_time"]
  }
}

Configurar para Zed

Adicione ao seu settings.json do Zed:

"context_servers": [
  "mcp-server-time": {
    "command": "uvx",
    "args": ["mcp-server-time"]
  }
],

"context_servers": {
  "mcp-server-time": {
    "command": "python",
    "args": ["-m", "mcp_server_time"]
  }
},

Personalização - Fuso Horário do Sistema

Por padrão, o servidor detecta automaticamente o fuso horário do seu sistema. Você pode substituir isso adicionando o argumento --local-timezone à lista args na configuração.

Exemplo:

{
  "command": "python",
  "args": ["-m", "mcp_server_time", "--local-timezone=America/New_York"]
}

Exemplos de Interações

1. Obter hora atual:

{
  "name": "get_current_time",
  "arguments": {
    "timezone": "Europe/Warsaw"
  }
}

Resposta:

{
  "timezone": "Europe/Warsaw",
  "datetime": "2024-01-01T13:00:00+01:00",
  "is_dst": false
}

2. Converter hora entre fusos horários:

{
  "name": "convert_time",
  "arguments": {
    "source_timezone": "America/New_York",
    "time": "16:30",
    "target_timezone": "Asia/Tokyo"
  }
}

Resposta:

{
  "source": {
    "timezone": "America/New_York",
    "datetime": "2024-01-01T12:30:00-05:00",
    "is_dst": false
  },
  "target": {
    "timezone": "Asia/Tokyo",
    "datetime": "2024-01-01T12:30:00+09:00",
    "is_dst": false
  },
  "time_difference": "+13.0h",
}

Depuração

Você pode usar o inspetor MCP para depurar o servidor. Para instalações via uvx:

npx @modelcontextprotocol/inspector uvx mcp-server-time

Ou se você instalou o pacote em um diretório específico ou está desenvolvendo nele:

cd path/to/servers/src/time
npx @modelcontextprotocol/inspector uv run mcp-server-time

Exemplos de Perguntas para o Claude

1. "Que horas são agora?" (usará o fuso horário do sistema)
2. "Que horas são em Tóquio?"
3. "Quando são 16h em Nova York, que horas são em Londres?"
4. "Converta 9h30 da manhã, horário de Tóquio, para o horário de Nova York"

Build

Build Docker:

cd src/time
docker build -t mcp/time .

Contribuindo

Incentivamos contribuições para ajudar a expandir e melhorar o mcp-server-time. Se você deseja adicionar novas ferramentas relacionadas a tempo, aprimorar funcionalidades existentes ou melhorar a documentação, sua contribuição é valiosa.

Para exemplos de outros servidores MCP e padrões de implementação, consulte: https://github.com/modelcontextprotocol/servers

Pull requests são bem-vindos! Sinta-se à vontade para contribuir com novas ideias, correções de bugs ou melhorias para tornar o mcp-server-time ainda mais poderoso e útil.

Licença

O mcp-server-time é 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. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.