mcp-todo-server

Базовый MCP-сервер (Model Context Protocol), предоставляющий список задач (to-do list), реализованный на TypeScript с использованием официального SDK @modelcontextprotocol/sdk.

Внеаудиторная работа 1 — Программирование IV — Model Context Protocol.

Предоставляемые возможности

Related MCP server: MCP Todo Server

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

mcp-todo-server/
├── src/
│   └── server.ts       # Servidor MCP principal
├── tasks.json           # Almacenamiento de tareas (base de datos simple)
├── tsconfig.json        # Configuración de TypeScript
├── package.json
└── README.md

Требования

• Node.js 18 или выше

• npm

Установка

npm install

Это устанавливает зависимости: @modelcontextprotocol/sdk, zod (валидация схем), а в качестве зависимостей для разработки — typescript, @types/node и tsx.

Запуск

Режим разработки (запускает TypeScript напрямую, без компиляции):

npm run dev

Производственный режим (компилирует в JavaScript, а затем запускает):

npm run build
npm start

Сервер взаимодействует через stdio (стандартный ввод/вывод) — транспорт, используемый Claude Desktop и большинством локальных MCP-клиентов. При успешном запуске вы увидите в терминале:

Servidor MCP 'mcp-todo-server' corriendo por stdio...

Это сообщение намеренно выводится в stderr, чтобы не мешать JSON-RPC-сообщениям, которые идут через stdout.

Как протестировать без графического клиента

Можно использовать официальный Inspector MCP, который открывает веб-интерфейс для вызова Resources, Tools и Prompts вручную:

npx @modelcontextprotocol/inspector npx tsx src/server.ts

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

Чтение resource задач → возвращает массив tasks из tasks.json в формате JSON.

Tool add_task, аргументы:

{ "name": "Repasar JSON-RPC", "description": "Leer la especificación 2.0", "priority": "media" }

Tool complete_task, аргументы:

{ "id": 1 }

Prompt daily_summary не принимает аргументов: автоматически формирует сводку с незавершёнными и выполненными задачами, сгруппированными по приоритету.

Автор

Камила — Национальный университет Коста-Рики, Программирование IV.