Time

Time MCP Server

Um servidor Model Context Protocol que fornece recursos 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.

Fonte: https://github.com/modelcontextprotocol/servers/tree/main/src/time

Requer MCP Python SDK 1.x (mcp>=1.29.0,<2). O SDK 2.0 renomeou APIs que este servidor utiliza. A migração para v2 está em andamento.

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 o mcp-server-time.

uvx 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", "-e", "LOCAL_TIMEZONE", "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"]
  }
},

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 arquivo User Settings (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 workspace. Isso permitirá compartilhar 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": ["mcp-server-time"]
      }
    }
  }
}

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

Configurar para Zencoder

1. Vá ao menu do Zencoder (...)
2. No menu suspenso, selecione Agent Tools
3. Clique em Add Custom MCP
4. Adicione o nome e a configuração do servidor abaixo e certifique-se de clicar no botão Install

{
    "command": "uvx",
    "args": ["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 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 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 do horário de Tóquio para o horário de Nova York"

Compilação

Docker build:

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.