MCP Time Server

Um servidor simples que fornece a hora UTC atual.

GitHub

Documentação

MCP Time Server

Um servidor simples do Model Context Protocol (MCP) que fornece funcionalidade de horário UTC atual. Este servidor pode ser integrado globalmente com o Cursor IDE para fornecer recursos relacionados a horário em todos os projetos.

Recursos

  • Obter o horário UTC atual em vários formatos
  • Implementação simples do protocolo MCP
  • Integração global com o Cursor IDE
  • Leve e rápido

Instalação

Pré-requisitos

  • Python 3.8 ou superior
  • Gerenciador de pacotes pip

Instalar a partir do código-fonte

  1. Clone ou baixe este repositório
  2. Navegue até o diretório do projeto
  3. Instale o pacote:
pip install -e .

Instalar apenas as dependências

pip install -r requirements.txt

Uso

Executando o servidor

# Run directly
python -m mcp_time_server.server

# Or use the installed script
mcp-time-server

Ferramentas Disponíveis

get_current_time_utc

Obtenha o horário UTC atual em vários formatos.

Parâmetros:

  • format (opcional): Formato de saída
    • "iso" (padrão): Formato ISO 8601 (2025-01-15T10:30:45Z)
    • "datetime": Formato legível (2025-01-15 10:30:45)
    • "timestamp": Timestamp Unix (1736939445)

Exemplo de resposta:

Current UTC time: 2025-01-15T10:30:45.123456Z
Format: iso
Full ISO: 2025-01-15T10:30:45.123456Z

Integração com o Cursor IDE

Configuração Global (Recomendada)

Para integração permanente em todos os projetos:

  1. Crie o arquivo de configuração global do MCP:

    • Windows: C:\Users\[USERNAME]\.cursor\mcp.json
    • macOS/Linux: ~/.cursor/mcp.json

  2. Adicione a seguinte configuração:

{
  "mcpServers": {
    "time-server": {
      "command": "python",
      "args": ["-m", "mcp_time_server.server"],
      "cwd": "/full/path/to/mcp-time-server/src",
      "env": {
        "PYTHONPATH": "/full/path/to/mcp-time-server/src"
      }
    }
  }
}
  1. Reinicie o Cursor IDE
  2. Verifique Tools & Integrations > MCP para confirmar que o servidor está habilitado

O servidor agora iniciará automaticamente com o Cursor IDE e funcionará em todos os projetos!

Configuração Específica do Projeto

Para uso apenas no projeto, crie .cursor/mcp.json no diretório do seu projeto com a mesma estrutura.

Desenvolvimento

Configuração de Desenvolvimento

# Install with development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black src/
isort src/

# Type checking
mypy src/

Estrutura do Projeto

mcp-time-server/
├── src/
│   └── mcp_time_server/
│       ├── __init__.py
│       └── server.py
├── pyproject.toml
├── requirements.txt
├── README.md
├── mcp_config.json
└── PROJECT_PLAN.md

Testes

Teste a funcionalidade do servidor:

from mcp_time_server.server import get_current_time_utc

# Test different formats
print(get_current_time_utc("iso"))
print(get_current_time_utc("datetime"))
print(get_current_time_utc("timestamp"))

Solução de Problemas

Problemas Comuns

  1. Erros de importação: Certifique-se de que o pacote está instalado com pip install -e .
  2. Problemas de conexão MCP: Verifique o caminho do servidor na sua configuração MCP
  3. Erros de permissão: Garanta que o Python tenha as permissões necessárias para executar o servidor
  4. Servidor não aparecendo: Verifique se o diretório .cursor existe e se mcp.json está formatado corretamente

Windows PowerShell

Se você encontrar problemas com o operador && no PowerShell, use:

cd src; python -m mcp_time_server.server

Verificando o Status do Servidor

Verifique se o servidor está em execução:

# Windows
tasklist | findstr python
wmic process where "name='python.exe'" get ProcessId,CommandLine /format:list

# macOS/Linux  
ps aux | grep mcp_time_server

Teste a conexão no Cursor: Peça ao assistente de IA para obter o horário atual - ele deve usar o MCP Time Server automaticamente.

Gerenciamento Manual do Servidor

Inicie o servidor manualmente:

cd src && python -m mcp_time_server.server

Pare o servidor:

# Windows (replace PID with actual process ID)
taskkill /PID [PID] /F

Licença

Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Contribuição

  1. Faça um fork do repositório
  2. Crie um branch de funcionalidade
  3. Faça suas alterações
  4. Adicione testes se aplicável
  5. Envie um pull request

Registro de Alterações

v0.1.0

  • Lançamento inicial
  • Funcionalidade básica de horário UTC
  • Conformidade com o protocolo MCP
  • Integração FastMCP para gerenciamento simplificado do servidor
  • Suporte à configuração global do Cursor IDE
  • Múltiplos formatos de horário (ISO, datetime, timestamp)
  • Testes e documentação abrangentes
  • Ferramentas de gerenciamento de processos e solução de problemas
  • Repositório GitHub com licença MIT
  • Testes ao vivo confirmados em ciclos de reinicialização