Time MCP Server

Servidor Time MCP

Um servidor Model Context Protocol que fornece recursos de hora e conversão de 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 fuso horário IANA, com detecção automática do fuso horário do sistema.

Ferramentas Disponíveis

• get_current_time - Obter 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 - Converter 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 pape-mcp-server-time.

Usando PIP

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

pip install pape-mcp-server-time

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

python -m pape_mcp_server_time

Configuração

Configurar para Claude.app

Adicione às suas configurações do Claude:

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

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

Configurar para Zed

Adicione ao seu arquivo settings.json do Zed:

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

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

Configurar para VS Code

Para instalação rápida, use um dos botões de instalação com um clique abaixo...

Para instalação manual, adicione o seguinte bloco JSON ao seu arquivo de Configurações do Usuário (JSON) no VS Code. Você pode fazer isso pressionando Ctrl + Shift + P e digitando Preferences: Open User Settings (JSON).

Opcionalmente, você pode adicioná-lo a um arquivo chamado .vscode/mcp.json no seu espaço de trabalho. Isso permitirá que você compartilhe a configuração com outras pessoas.

Observe que a chave mcp é necessária ao usar o arquivo mcp.json.

{
  "mcp": {
    "servers": {
      "time": {
        "command": "uvx",
        "args": ["pape-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", "pape_mcp_server_time", "--local-timezone=America/New_York"]
}

Exemplos de Interações

1. Obter a 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 pape-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 pape-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 do horário de Tóquio para o horário de Nova York"

Contribuindo

Incentivamos contribuições para ajudar a expandir e melhorar o pape-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 pape-mcp-server-time ainda mais poderoso e útil.

Licença

O pape-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.