mcp-todo-server

Einfacher MCP-Server (Model Context Protocol), der eine Aufgabenliste (To-do-Liste) bereitstellt, implementiert in TypeScript mit dem offiziellen SDK @modelcontextprotocol/sdk.

Hausaufgabe 1 — Programmierung IV — Model Context Protocol.

Bereitgestellte Funktionen

Related MCP server: MCP Todo Server

Projektstruktur

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

Voraussetzungen

• Node.js 18 oder höher

• npm

Installation

npm install

Dies installiert die Abhängigkeiten: @modelcontextprotocol/sdk, zod (Schemaprüfung) sowie die Entwicklungsabhängigkeiten typescript, @types/node und tsx.

Ausführung

Entwicklungsmodus (führt TypeScript direkt aus, ohne zu kompilieren):

npm run dev

Produktionsmodus (kompiliert zu JavaScript und führt dann aus):

npm run build
npm start

Der Server kommuniziert über stdio (Standard-Eingabe/Ausgabe), das Transportprotokoll, das von Claude Desktop und den meisten MCP-Clients verwendet wird. Beim erfolgreichen Start siehst du in der Konsole:

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

Diese Meldung erscheint absichtlich über stderr, um die JSON-RPC-Kommunikation über stdout nicht zu beeinträchtigen.

So testest du ohne grafische Oberfläche

Du kannst den offiziellen Inspector von MCP verwenden, der eine Weboberfläche zum Aufrufen von Resources, Tools und Prompts bereitstellt:

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

Verwendungsbeispiele für jede Funktion

Resource „Aufgaben lesen“ → gibt das Array tasks aus tasks.json im JSON-Format zurück.

Tool add_task, Argumente:

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

Tool complete_task, Argumente:

{ "id": 1 }

Prompt daily_summary benötigt keine Argumente: erstellt automatisch eine Zusammenfassung der offenen und abgeschlossenen Aufgaben, gruppiert nach Priorität.

Autor

Camila — Universidad Nacional de Costa Rica, Programmierung IV.