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.

Related MCP server: mcp-discord-chat MCP server

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

2. Crear un entorno virtual:

uv venv
source .venv/bin/activate

3. 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

2. Distribuciones de paquetes de compilación:

uv build

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

3. 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