MCP Todo Server

Servidor MCP desarrollado en Python para la gestión básica de tareas almacenadas localmente en un archivo JSON.

El proyecto implementa las principales capacidades de Model Context Protocol (MCP): Resources, Tools y Prompts, permitiendo consultar tareas pendientes, registrar nuevas tareas, marcar tareas como completadas y generar una plantilla de resumen diario.

Funcionalidades

El servidor expone las siguientes capacidades:

Resource — tasks://pending

Retorna las tareas que se encuentran pendientes en tasks.json.

Las tareas completadas permanecen almacenadas, pero no son incluidas en el resultado del Resource.

Tool — add_task

Permite registrar una nueva tarea proporcionando:

• nombre;

• descripción;

• prioridad (alta, media o baja).

Cada tarea recibe automáticamente un identificador con el formato:

T-001
T-002
T-003

La herramienta también valida que la tarea tenga un nombre y que la prioridad corresponda con uno de los valores permitidos.

Tool — complete_task

Permite marcar una tarea como completada utilizando su identificador.

Por ejemplo:

T-001

Al encontrar la tarea, su estado completada cambia de false a true y el cambio se guarda en tasks.json.

Prompt — daily_summary

Genera una plantilla basada en el estado actual de las tareas.

Considera:

• total de tareas;

• tareas completadas;

• tareas pendientes;

• tareas pendientes de prioridad alta.

La plantilla permite generar un resumen del progreso general y orientar la atención hacia las actividades de mayor prioridad.

Related MCP server: Tasks MCP Server

Estructura del proyecto

mcp-todo-server/
│
├── server.py
├── tasks.json
├── requirements.txt
├── README.md
└── .gitignore

El directorio .venv corresponde al entorno virtual local y no se incluye en el repositorio.

Modelo de datos

Las tareas se almacenan en formato JSON con la siguiente estructura:

{
    "id": "T-001",
    "nombre": "Revisar documento del extraclase",
    "descripcion": "Comprobar que las capturas y explicaciones estén completas",
    "prioridad": "alta",
    "completada": true
}

El campo id identifica cada tarea, mientras que completada permite determinar si debe aparecer en el Resource de tareas pendientes.

Requisitos

Para ejecutar el proyecto se requiere:

• Python 3

• pip

• Model Context Protocol SDK para Python

Instalación

1. Clonar el repositorio

git clone URL_DEL_REPOSITORIO
cd mcp-todo-server

2. Crear el entorno virtual

En Windows:

python -m venv .venv

3. Activar el entorno virtual

En PowerShell:

.\.venv\Scripts\Activate.ps1

4. Instalar las dependencias

python -m pip install -r requirements.txt

Ejecución

Con el entorno virtual activo, ejecutar:

python server.py

El servidor utiliza comunicación mediante entrada y salida estándar (stdio) y permanece en ejecución esperando la conexión de un cliente MCP.

Para detenerlo:

Ctrl + C

Pruebas con MCP Inspector

El funcionamiento del servidor puede comprobarse mediante MCP Inspector.

Utilizando pnpm:

pnpm dlx @modelcontextprotocol/inspector python server.py

Una vez establecida la conexión, el cliente permite descubrir e interactuar con las capacidades expuestas:

Resources
└── tasks://pending

Tools
├── add_task
└── complete_task

Prompts
└── daily_summary

Las pruebas permiten verificar la consulta de tareas, la modificación de tasks.json mediante las Tools y la generación de la plantilla de resumen diario.

Tecnologías utilizadas

• Python

• Model Context Protocol (MCP)

• JSON

• MCP Inspector

• Git

Autora

Jendry Linneth Murillo Pérez
Programación IV
II Ciclo, 2026