mcp-server

eduwin30/mcp-server

3.1

If you are the rightful owner of mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MCP Server is a Python microservice for managing tasks and personal notes with local JSON persistence.

MCP Server - Gestor de Tareas y Notas

Descripción

MCP Server es un microservicio Python que permite gestionar tareas y notas personales de forma sencilla, con persistencia local en un archivo JSON. Incluye funciones avanzadas como el registro opcional de hora para tareas y la simulación de agendado en un calendario de Teams.

Ideal para automatizar tu organización diaria, registrar pendientes, tomar notas rápidas y simular recordatorios de reuniones.

Funcionalidades Principales

  • Agregar tareas con título, fecha y hora opcionales.
  • Simulación de agendado en Teams: si se especifica hora, la tarea se registra como evento simulado.
  • Listar tareas (todas o solo pendientes), mostrando fecha, hora y estado.
  • Completar tareas por ID.
  • Agregar notas rápidas.
  • Buscar notas por palabra clave.
  • Persistencia local: todos los datos se guardan en ./data/data.json dentro del proyecto.

Estructura de Datos

  • Tareas: Cada tarea incluye id, title, due (fecha), time (hora), completed, created_at y, si aplica, calendar_event.
  • Notas: Cada nota incluye id, text, created_at.

Requisitos Previos

  • Python 3.8 o superior
  • Instalar dependencias con pip:
pip install -r requirements.txt

Cómo levantar el servicio

  1. Asegúrate de tener el entorno virtual activado (opcional pero recomendado):

    python -m venv venv
source venv/bin/activate

  2. Instala las dependencias:

    pip install -r requirements.txt

  3. Ejecuta el servidor MCP:

    python server.py

    El servidor se ejecuta en modo STDIO, ideal para integraciones con asistentes como Claude Desktop.

Ejemplo de Uso

Agregar una tarea con hora y simulación de Teams

add_task("Reunión con manager", due="2025-05-12", time="16:00")

Listar tareas

list_tasks()

Completar una tarea

complete_task(1)

Agregar una nota

add_note("Llamar a soporte técnico")

Buscar notas

search_notes("soporte")

Notas Adicionales

  • Todos los datos se almacenan en ./data/data.json para fácil acceso y respaldo.
  • El sistema simula la integración con Teams para tareas con hora, ideal para presentaciones o prototipos.
  • Puedes extender el proyecto agregando exportación/importación de datos, integración real con APIs de calendario, o una interfaz web/CLI.

¡Listo para organizarte y destacar con tu MCP Server!