\# 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:

```bash

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

   cd mcp-todo-server

```



2\. Crear y activar un entorno virtual:

```bash

   python -m venv venv

   venv\\Scripts\\activate

```



3\. Instalar las dependencias:

```bash

   pip install -r requirements.txt

```



\## Ejecución



\### Modo desarrollo (con MCP Inspector)



```bash

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`:



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