mcp-todo-server

# MCP Todo Server

Servidor MCP básico para gestión de tareas pendientes, desarrollado como parte

del Trabajo Extraclase 1 (MCP) — Programación IV, Universidad Latina de Costa Rica.

Autor: Adonis Fabricio Fajardo Rojas

## Descripción

Este servidor expone las siguientes capacidades mediante el Model Context Protocol:

- **Resource** tasks://all: retorna la lista completa de tareas en formato JSON.

- **Tool** add\_task(nombre, descripcion, prioridad): agrega una nueva tarea.

- **Tool** complete\_task(task\_id): marca una tarea como completada dado su ID.

- **Prompt** daily\_summary: genera una plantilla de resumen del estado de las tareas.

## Requisitos

- Python 3.10 o superior

- pip

## Instalación

1. Clonar el repositorio:

   git clone \[URL-de-tu-repo]

   cd mcp-todo-server

2. Crear y activar un entorno virtual:

   python -m venv venv

   venv\\Scripts\\activate

3. Instalar las dependencias:

   pip install -r requirements.txt

## Ejecución

### Modo desarrollo (con MCP Inspector)

mcp dev server.py

Esto abre una interfaz web local para probar los Resources, Tools y Prompts

directamente sin necesidad de un cliente MCP completo.

### Conexión con Claude Desktop

Agregar la siguiente configuración al archivo claude\_desktop\_config.json:

{

  "mcpServers": {

    "todo-server": {

      "command": "python",

      "args": \["C:\\\\Users\\\\adoni\\\\mcp-todo-server\\\\server.py"]

    }

  }

}

## Estructura del proyecto

mcp-todo-server/

├── server.py # Servidor MCP principal

├── tasks.json # Almacenamiento de tareas

├── requirements.txt # Dependencias

└── README.md # Este archivo

## Notas de compatibilidad

Este proyecto usa el SDK oficial mcp==1.29.0. No se recomienda actualizar a

mcp>=2.0.0, ya que esa versión introduce cambios incompatibles (renombra

FastMCP a MCPServer, entre otros) y no está garantizada su compatibilidad

con Claude Desktop al momento de este trabajo.