MCP Todo Server

Сервер MCP, разработанный на Python для базового управления задачами, хранящимися локально в файле JSON.

Проект реализует основные возможности Model Context Protocol (MCP): Resources, Tools и Prompts, позволяя просматривать ожидающие задачи, регистрировать новые задачи, отмечать задачи как выполненные и генерировать шаблон ежедневного отчёта.

Функциональность

Сервер предоставляет следующие возможности:

Resource — tasks://pending

Возвращает задачи, которые находятся в ожидании в tasks.json.

Выполненные задачи остаются в хранилище, но не включаются в результат Resource.

Tool — add_task

Позволяет зарегистрировать новую задачу, указав:

• имя;

• описание;

• приоритет (высокий, средний или низкий).

Каждая задача автоматически получает идентификатор в формате:

T-001
T-002
T-003

Инструмент также проверяет, что задача имеет имя и что приоритет соответствует одному из допустимых значений.

Tool — complete_task

Позволяет отметить задачу как выполненную, используя её идентификатор.

Например:

T-001

При нахождении задачи её статус выполнена меняется с false на true, и изменение сохраняется в tasks.json.

Prompt — daily_summary

Генерирует шаблон на основе текущего состояния задач.

Учитывает:

• общее количество задач;

• выполненные задачи;

• ожидающие задачи;

• ожидающие задачи с высоким приоритетом.

Шаблон позволяет создать отчёт об общем прогрессе и направить внимание на наиболее приоритетные действия.

Related MCP server: Tasks MCP Server

Структура проекта

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

Каталог .venv соответствует локальному виртуальному окружению и не включается в репозиторий.

Модель данных

Задачи хранятся в формате JSON со следующей структурой:

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

Поле id идентифицирует каждую задачу, а выполнена позволяет определить, должна ли она отображаться в Resource ожидающих задач.

Требования

Для запуска проекта требуется:

• Python 3

• pip

• Model Context Protocol SDK для Python

Установка

1. Клонировать репозиторий

git clone URL_DEL_REPOSITORIO
cd mcp-todo-server

2. Создать виртуальное окружение

В Windows:

python -m venv .venv

3. Активировать виртуальное окружение

В PowerShell:

.\.venv\Scripts\Activate.ps1

4. Установить зависимости

python -m pip install -r requirements.txt

Запуск

С активным виртуальным окружением выполнить:

python server.py

Сервер использует взаимодействие через стандартный ввод и вывод (stdio) и остаётся в работе, ожидая подключения клиента MCP.

Для остановки:

Ctrl + C

Тестирование с MCP Inspector

Работу сервера можно проверить с помощью MCP Inspector.

Используя pnpm:

pnpm dlx @modelcontextprotocol/inspector python server.py

После установки соединения клиент позволяет обнаружить и взаимодействовать с предоставленными возможностями:

Resources
└── tasks://pending

Tools
├── add_task
└── complete_task

Prompts
└── daily_summary

Тестирование позволяет проверить запрос задач, изменение tasks.json с помощью Tools и генерацию шаблона ежедневного отчёта.

Используемые технологии

• Python

• Model Context Protocol (MCP)

• JSON

• MCP Inspector

• Git

Автор

Jendry Linneth Murillo Pérez Программирование IV II семестр, 2026