MCP-сервер задач

Проект для внеаудиторной работы 1 по программированию IV. Реализует сервер Model Context Protocol (MCP), который управляет задачами в локальном JSON-файле и предоставляет один ресурс, два инструмента и один промпт.

Возможности

• Resource tasks://pending: возвращает только незавершённые задачи.

• Tool add_task: добавляет задачу с названием, описанием и приоритетом (alta, media или baja).

• Tool complete_task: отмечает существующую задачу как выполненную по ID.

• Prompt daily_summary: формирует шаблон с текущим состоянием для создания ежедневной сводки.

Сервер использует транспорт stdio. Хост или клиент запускает его как подпроцесс, а сообщения MCP передаются через stdin и stdout.

Related MCP server: TaskTrek MCP Server

Требования

• Python 3.11 или новее.

• Доступ к терминалу.

• Claude Desktop, MCP Inspector или другой совместимый MCP-клиент для интеграции.

Установка

Windows (PowerShell)

cd C:\RUTA\mcp-todo-server
py -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt

macOS или Linux

cd /RUTA/mcp-todo-server
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

Запуск

Сервер stdio ожидает, что клиент отправит первое сообщение; поэтому при прямом запуске он не выводит меню и не открывает порт:

python server.py

Используйте Ctrl+C для остановки.

Демонстрационный клиент

client_demo.py — это совместимый MCP-клиент, созданный с помощью официального SDK. Он подключается через stdio, обнаруживает возможности и выполняет все операции, требуемые в задании:

python client_demo.py --reset

Чтобы сохранить транскрипт в UTF-8:

python client_demo.py --reset --output evidence/client_demo_output.txt

Опция --reset восстанавливает две исходные записи перед тестом. Демонстрация запрашивает Resource, добавляет две задачи, завершает одну, получает Prompt и снова запрашивает Resource.

Автоматизированные тесты

python -m pytest -q

Набор проверяет:

1. Обнаружение Resource, Tools и Prompt.

2. Получение только незавершённых задач.

3. Создание и завершение задач.

4. Динамическое содержимое daily_summary.

5. Обработку ошибки при завершении несуществующего ID.

MCP Inspector

При установленном Node.js можно запустить официальный интерфейс:

npx @modelcontextprotocol/inspector .venv/Scripts/python.exe server.py

В macOS или Linux замените исполняемый файл на .venv/bin/python.

Настройка Claude Desktop

1. Откройте claude_desktop_config.example.json.

2. Замените C:\\mcp-todo на абсолютный путь к проекту.

3. Скопируйте запись mcpServers в файл конфигурации Claude Desktop. Обычно он находится по адресу: %APPDATA%\Claude\claude_desktop_config.json в Windows, ~/Library/Application Support/Claude/claude_desktop_config.json в macOS и ~/.config/Claude/claude_desktop_config.json в Linux.

4. Полностью закройте и снова откройте Claude Desktop.

{
  "mcpServers": {
    "todo-server": {
      "command": "C:\\RUTA\\mcp-todo-server\\.venv\\Scripts\\python.exe",
      "args": ["C:\\RUTA\\mcp-todo-server\\server.py"]
    }
  }
}

Не используйте относительные пути: хост может запустить сервер из другого каталога.

Структура

mcp-todo-server/
  server.py
  client_demo.py
  tasks.json
  requirements.txt
  claude_desktop_config.example.json
  tests/
    test_server.py
  diagramas/
    arquitectura_mcp_ecommerce.mmd
    flujo_consulta_inventario.mmd
  evidence/
    client_demo_output.txt
    01_inspector_connected.png
    02_add_task_result.png
    03_complete_task_result.png
    04_resource_pending.png
    05_daily_summary_prompt.png

Публикация в Git

git init
git add .
git commit -m "Implementar servidor MCP de tareas"
git branch -M main
git remote add origin URL_DEL_REPOSITORIO
git push -u origin main

Окончательный URL репозитория необходимо добавить в отчёт перед сдачей.

Технические ссылки

• MCP Python SDK

• MCP Specification

• MCP Inspector