MCP Datetime

mcp-datetime

English | 日本語

Um serviço de formatação de data e hora implementado como um servidor MCP para o Claude Desktop Application. Suporta a geração de strings de data e hora em vários formatos.

Nota: Este pacote foi testado apenas no macOS. A compatibilidade com Windows não foi verificada.

Pré-requisitos

Antes de usar o mcp-datetime, certifique-se de ter as seguintes ferramentas instaladas:

• Python 3.12 ou posterior
• uv (instalador de pacotes Python)
• uvx (executor de pacotes Python)

Recursos

• ✨ Suporte a vários formatos de data e hora
• 🇯🇵 Suporte ao idioma japonês
• 📁 Formatos otimizados para geração de nomes de arquivo
• 🌏 Tratamento preciso de fusos horários
• 🔧 Integração perfeita com o Claude Desktop App

Componentes do Servidor MCP

Ferramentas

O servidor implementa uma ferramenta:

• get_datetime: Obter data e hora atuais em vários formatos
  • Aceita "format" como argumento obrigatório do tipo string
  • Retorna uma string de data e hora formatada com base no formato especificado
  • Suporta vários tipos de formato, incluindo padrão, japonês e ISO

Uso com o Claude Desktop App

Adicione o seguinte ao seu arquivo de configuração:

Localização do arquivo de configuração (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json

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

Sobre a Instalação

Se você precisar instalar o pacote diretamente (por exemplo, para desenvolvimento ou inspeção do código-fonte), você pode usar um destes métodos:

• Instalar a partir do PyPI

  pip install mcp-datetime
  

• Instalar a partir do código-fonte do GitHub

  git clone https://github.com/ZeparHyfar/mcp-datetime.git
  cd mcp-datetime
  pip install -e .
  

• Exemplo de claude_desktop_config.json para instalação manual

  {
    "mcpServers": {
      "mcp-datetime": {
        "command": "python",
        "args": ["-m", "mcp_datetime"],
        "env": {
          "PYTHON": "/path/to/your/python"
        }
      }
    }
  }
  

  Substitua "/path/to/your/python" pelo caminho real do seu interpretador Python

  ex.: "/usr/local/bin/python3" ou "/Users/username/.pyenv/versions/3.12.0/bin/python3"

Exemplos Básicos

• Formato de comando

  # Standard datetime format
  call datetime-service.get_datetime {"format": "datetime"}
  # Result: 2024-12-10 00:54:01
  
  # Japanese format
  call datetime-service.get_datetime {"format": "datetime_jp"}
  # Result: 2024年12月10日 00時54分01秒
  
  # Filename format
  call datetime-service.get_datetime {"format": "filename_md"}
  # Result: 20241210005401.md
  

• Exemplos de prompts do Claude Desktop App

  • Usuário

    Please tell me the current time in date_slash format
    

  • Claude

    I'll get the current date in date_slash format.
    
    The current date is 2024/12/12
    

Formatos Suportados

Nome do Formato	Exemplo	Descrição
date	2024-12-10	Formato de data padrão
date_slash	2024/12/10	Data com barras
date_jp	2024年12月10日	Formato de data japonês
datetime	2024-12-10 00:54:01	Data e hora padrão
datetime_jp	2024年12月10日 00時54分01秒	Data e hora em japonês
datetime_t	2024-12-10T00:54:01	Data e hora com separador T
compact	20241210005401	Formato compacto para IDs
compact_date	20241210	Apenas data compacta
compact_time	005401	Apenas hora compacta
filename_md	20241210005401.md	Nome de arquivo Markdown
filename_txt	20241210005401.txt	Nome de arquivo de texto
filename_log	20241210005401.log	Nome de arquivo de log
iso	2024-12-10T00:54:01+0900	Formato ISO 8601
iso_basic	20241210T005401+0900	Formato ISO básico
log	2024-12-10 00:54:01.123456	Formato de log com microssegundos
log_compact	20241210_005401	Formato de log compacto
time	00:54:01	Apenas hora
time_jp	00時54分01秒	Formato de hora japonês

Depuração

Como os servidores MCP são executados via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector:

• Usando o pacote PyPI

  npx @modelcontextprotocol/inspector uvx mcp-datetime
  

• Usando o código-fonte baixado do GitHub

  git clone https://github.com/ZeparHyfar/mcp-datetime.git
  npx @modelcontextprotocol/inspector uvx --directory ./mcp-datetime run mcp-datetime
  

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.