Time MCP Server

Time MCP Server

Modificado a partir do projeto oficial MCP
Autor original: Mariusz 'maledorak' Korzekwa
Repositório original: modelcontextprotocol/servers
Caminho do projeto original: src/time

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

Observação: esta versão removeu o recurso de conversão de fuso horário, mantendo apenas o recurso de obter a hora atual.

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')

Instalação

Usando uv (recomendado)

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

Usando PIP

Alternativamente, você pode instalar 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

Usando Docker com Suporte a SSE

Compile e execute com mcp-proxy para acesso HTTP/SSE:

# Build the SSE-enabled Docker image
docker build -f Dockerfile.sse -t mcp-time-sse .

# Run the container (accessible via HTTP on port 8999)
docker run -p 8999:8999 mcp-time-sse

Configuração

Configurar para Claude.app

Adicione às suas configurações do Claude:

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": ["mcp-server-time", "--local-timezone", "Asia/Shanghai"]
    }
  }
}

{
  "mcpServers": {
    "time": {
      "command": "uv",
      "args": [
        "run", 
        "--directory", 
        "D:/WorkSpace/demo/servers/src/time",
        "mcp-server-time",
        "--local-timezone",
        "Asia/Shanghai"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "time": {
      "command": "python",
      "args": ["-m", "mcp_server_time", "--local-timezone", "Asia/Shanghai"]
    }
  }
}

Configurar para Zed

Adicione ao seu settings.json do Zed:

"context_servers": [
  "mcp-server-time": {
    "command": "uvx",
    "args": ["mcp-server-time", "--local-timezone", "Asia/Shanghai"]
  }
],

"context_servers": {
  "mcp-server-time": {
    "command": "python",
    "args": ["-m", "mcp_server_time", "--local-timezone", "Asia/Shanghai"]
  }
},

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 workspace. 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": ["mcp-server-time", "--local-timezone", "Asia/Shanghai"]
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "time": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/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=Asia/Shanghai"]
}

Exemplos de Interações

1. Obter a hora atual:

{
  "name": "get_current_time",
  "arguments": {
    "timezone": "Asia/Shanghai"
  }
}

Resposta:

{
  "timezone": "Asia/Shanghai",
  "datetime": "2024-01-01T20:00:00+08:00",
  "is_dst": false
}

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. "Que horas são em Nova York?"
4. "Obtenha a hora atual em Londres"

Compilação

Compilação Docker:

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

Compilação Docker com suporte a SSE:

cd time
docker build -f Dockerfile.sse -t mcp-time-sse .

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.