Skip to main content
Glama

Datetime MCP Server

by bossjones

Servidor MCP de fecha y hora

Un servidor MCP (Protocolo de finalización de modelos) que proporciona funcionalidad de fecha y hora junto con una gestión sencilla de notas.

Descripción general

Este servidor implementa el protocolo MCP y ofrece varias herramientas y recursos relacionados con la fecha y hora, incluidos:

  • Fecha y hora actuales en diferentes formatos
  • Utilidades de formato de fecha
  • Indicaciones para la programación de eventos
  • Funcionalidad de gestión de notas sencilla

Cualquier cliente MCP puede utilizar el servidor para acceder a información de fecha y hora y administrar notas simples.

Características

Recursos

El servidor proporciona los siguientes recursos:

  • datetime://current - La fecha y hora actuales
  • datetime://today - Fecha de hoy en formato ISO
  • datetime://time - La hora actual en formato de 24 horas
  • note://internal/{name} - Notas creadas por el usuario

Herramientas

El servidor proporciona las siguientes herramientas:

  • add-note - Agrega una nueva nota con un nombre y contenido
  • get-current-time : obtiene la hora actual en varios formatos (ISO, legible, marca de tiempo Unix, RFC3339)
  • format-date - Formatea una cadena de fecha según un patrón de formato especificado

Indicaciones

El servidor proporciona las siguientes indicaciones:

  • summarize-notes : crea un resumen de todas las notas
  • schedule-event : ayuda a programar un evento en un momento específico

Instalación

  1. Clonar el repositorio:
git clone https://github.com/bossjones/datetime-mcp-server.git cd datetime-mcp-server
  1. Crear un entorno virtual:
uv venv source .venv/bin/activate
  1. Instalar las dependencias:
uv sync

Uso

Ejecución del servidor

Para ejecutar el servidor:

uv run python -m datetime_mcp_server.server

El servidor se iniciará y escuchará en stdin/stdout los mensajes del protocolo MCP.

Conectarse al servidor

Puede conectarse al servidor mediante cualquier cliente MCP. Por ejemplo, mediante la CLI de MCP:

uv run mcp connect datetime-mcp-server

Desarrollo

Instalación de dependencias de desarrollo

# Install all dependencies including development dependencies uv sync --dev

Ejecución de pruebas

Para ejecutar las pruebas:

uv run pytest tests/
Pruebas unitarias

Las pruebas unitarias verifican que las funciones individuales del servidor funcionen correctamente:

uv run pytest tests/acceptance/test_server.py
Pruebas de integración

Las pruebas de integración verifican que el servidor implementa correctamente el protocolo MCP:

uv run pytest tests/acceptance/test_server_integration.py

Gestión de dependencias

# Add a production dependency uv add package_name # Add a development dependency uv add --dev package_name # Sync dependencies from lockfile uv sync --frozen # List outdated packages uv outdated

Ejemplos

Uso del servidor con MCP CLI

Enumere los recursos disponibles:

uv run mcp resources list

Leer un recurso de fecha y hora:

uv run mcp resources read datetime://current

Añadir una nota:

uv run mcp tools call add-note --arguments '{"name": "meeting", "content": "Team meeting at 3pm"}'

Obtenga la hora actual en formato ISO:

uv run mcp tools call get-current-time --arguments '{"format": "iso"}'

Formatear una fecha:

uv run mcp tools call format-date --arguments '{"date": "2023-10-15", "format": "%B %d, %Y"}'

Tareas de Makefile

El proyecto incluye varias tareas Makefile para agilizar el desarrollo:

# Sync all dependencies with frozen lockfile make uv-sync-all # Sync only development dependencies make uv-sync-dev # Run tests make test

Construcción y publicación

Para preparar el paquete para su distribución:

  1. Sincronizar dependencias y actualizar el archivo de bloqueo:
uv sync
  1. Distribuciones de paquetes de compilación:
uv build

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

  1. Publicar en PyPI:
uv publish

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:

  • Token: --token o UV_PUBLISH_TOKEN
  • O nombre de usuario/contraseña: --username / UV_PUBLISH_USERNAME y --password / UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

npx @modelcontextprotocol/inspector uv --directory /Users/malcolm/dev/bossjones/datetime-mcp-server run datetime-mcp-server

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuyendo

  1. Bifurcar el repositorio
  2. Crear una rama de características
  3. Realiza tus cambios
  4. Ejecute las pruebas con uv run pytest
  5. Enviar una solicitud de extracción

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Este servidor permite a los usuarios almacenar, administrar y resumir notas utilizando un esquema URI personalizado, con funcionalidad para agregar nuevas notas y generar resúmenes con distintos niveles de detalle.

  1. Descripción general
    1. Características
      1. Recursos
      2. Herramientas
      3. Indicaciones
    2. Instalación
      1. Uso
        1. Ejecución del servidor
        2. Conectarse al servidor
      2. Desarrollo
        1. Instalación de dependencias de desarrollo
        2. Ejecución de pruebas
        3. Gestión de dependencias
      3. Ejemplos
        1. Uso del servidor con MCP CLI
      4. Tareas de Makefile
        1. Construcción y publicación
          1. Depuración
            1. Licencia
              1. Contribuyendo

                Related MCP Servers

                • A
                  security
                  A
                  license
                  A
                  quality
                  An MCP server for managing and persisting notes, offering CRUD operations, note summarization, and resource-based access via a note:// URI scheme.
                  Last updated -
                  4
                  6
                  Python
                  MIT License
                • -
                  security
                  F
                  license
                  -
                  quality
                  Facilitates note storage and summarization through custom URIs, allowing users to manage, summarize, and update notes with varying detail levels in a collaborative environment.
                  Last updated -
                  Python
                  • Apple
                • A
                  security
                  F
                  license
                  A
                  quality
                  This server provides a note storage system with a custom URI scheme, allowing users to add and summarize notes, with adjustable summary detail levels.
                  Last updated -
                  1
                  Python
                  • Apple
                • A
                  security
                  F
                  license
                  A
                  quality
                  A server for managing and summarizing notes using a custom URI scheme, with tools to add notes and create styled summaries.
                  Last updated -
                  4
                  1
                  Python
                  • Apple

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/bossjones/datetime-mcp-server'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server