MCP-Aufgabenserver

Projekt der Hausaufgabe 1 von Programmierung IV. Implementiert einen Model Context Protocol (MCP)-Server, der Aufgaben in einer lokalen JSON-Datei verwaltet und eine Ressource, zwei Werkzeuge und einen Prompt bereitstellt.

Fähigkeiten

• Ressource tasks://pending: gibt nur die nicht abgeschlossenen Aufgaben zurück.

• Werkzeug add_task: fügt eine Aufgabe mit Name, Beschreibung und Priorität (alta, media oder baja) hinzu.

• Werkzeug complete_task: markiert eine vorhandene Aufgabe anhand der ID als abgeschlossen.

• Prompt daily_summary: erstellt eine Vorlage mit dem aktuellen Status, um eine tägliche Zusammenfassung zu generieren.

Der Server verwendet den stdio-Transport. Der Host oder Client startet ihn als Unterprozess und die MCP-Nachrichten laufen über stdin und stdout.

Related MCP server: TaskTrek MCP Server

Voraussetzungen

• Python 3.11 oder höher.

• Zugriff auf ein Terminal.

• Claude Desktop, MCP Inspector oder ein anderer kompatibler MCP-Client für die Integration.

Installation

Windows (PowerShell)

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

macOS oder Linux

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

Ausführung

Der stdio-Server erwartet, dass ein Client die erste Nachricht sendet; daher druckt er bei direkter Ausführung kein Menü und öffnet keinen Port:

python server.py

Verwenden Sie Ctrl+C, um ihn zu stoppen.

Demo-Client

client_demo.py ist ein kompatibler MCP-Client, der mit dem offiziellen SDK erstellt wurde. Er verbindet sich über stdio, entdeckt die Fähigkeiten und führt alle im Übungsblatt geforderten Operationen aus:

python client_demo.py --reset

Um eine UTF-8-Transkription zu speichern:

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

Die Option --reset stellt die beiden anfänglichen Datensätze vor dem Test wieder her. Die Demo fragt die Ressource ab, fügt zwei Aufgaben hinzu, schließt eine ab, ruft den Prompt ab und fragt die Ressource erneut ab.

Automatisierte Tests

python -m pytest -q

Die Suite prüft:

1. Entdeckung der Ressource, der Werkzeuge und des Prompts.

2. Ausschließliches Lesen ausstehender Aufgaben.

3. Erstellung und Abschluss von Aufgaben.

4. Dynamischer Inhalt von daily_summary.

5. Behandlung des Fehlers beim Abschließen einer nicht vorhandenen ID.

MCP Inspector

Mit installiertem Node.js kann die offizielle Oberfläche geöffnet werden:

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

Unter macOS oder Linux ersetzen Sie die ausführbare Datei durch .venv/bin/python.

Konfiguration von Claude Desktop

1. Öffnen Sie claude_desktop_config.example.json.

2. Ersetzen Sie C:\\RUTA\\mcp-todo-server durch den absoluten Pfad des Projekts.

3. Kopieren Sie den Eintrag mcpServers in die Konfigurationsdatei von Claude Desktop. Unter Windows befindet sie sich normalerweise unter: %APPDATA%\Claude\claude_desktop_config.json.

4. Schließen Sie Claude Desktop vollständig und öffnen Sie es erneut.

Beispiel:

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

Verwenden Sie keine relativen Pfade: Der Host kann den Server aus einem anderen Verzeichnis starten.

Struktur

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

Veröffentlichung auf 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

Die endgültige URL des Repositorys muss vor der Abgabe in den Bericht aufgenommen werden.

Technische Referenzen

• MCP Python SDK

• MCP Specification

• MCP Inspector