MCP Todo Server

Basic MCP server for managing pending tasks, developed as part of the Out-of-Class Assignment 1 (MCP) — Programming IV, Universidad Latina de Costa Rica.

Author: Adonis Fabricio Fajardo Rojas

Description

This server exposes the following capabilities through the Model Context Protocol:

• Resource tasks://all: returns the complete list of tasks in JSON format.

• Tool add_task(nombre, descripcion, prioridad): adds a new task.

• Tool complete_task(task_id): marks a task as completed given its ID.

• Prompt daily_summary: generates a summary template of the task status.

Requirements

• Python 3.10 or higher

• pip

Installation

1. Clone the repository:

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

   cd mcp-todo-server

2. Create and activate a virtual environment:

   python -m venv venv

   venv\\Scripts\\activate

3. Install the dependencies:

   pip install -r requirements.txt

Execution

Development mode (with MCP Inspector)

mcp dev server.py

This opens a local web interface to test the Resources, Tools, and Prompts directly without needing a full MCP client.

Connection with Claude Desktop

Add the following configuration to the claude_desktop_config.json file:

{

  "mcpServers": {

    "todo-server": {

      "command": "python",

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

    }

  }

}

Project Structure

mcp-todo-server/ ├── server.py # Main MCP server ├── tasks.json # Task storage ├── requirements.txt # Dependencies └── README.md # This file

Compatibility Notes

This project uses the official SDK mcp==1.29.0. It is not recommended to update to mcp>=2.0.0, since that version introduces breaking changes (renames FastMCP to MCPServer, among others) and its compatibility with Claude Desktop is not guaranteed at the time of this work.