local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Mentioned as the source repository location for cloning the project with 'git clone https://github.com/bossjones/datetime-mcp-server.git'
Used for various development tasks through Makefile commands like 'make uv-sync-all'
Used to launch the MCP Inspector with 'npx @modelcontextprotocol/inspector'

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

Clonar el repositorio:

git clone https://github.com/bossjones/datetime-mcp-server.git
cd datetime-mcp-server

Crear un entorno virtual:

uv venv
source .venv/bin/activate

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:

Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync

Distribuciones de paquetes de compilación:

uv build

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

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

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

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

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.

Related Resources

Reddit Discussion about this server

Datetime MCP Server