Task-Manager MCP-Server

Ein lokaler MCP (Model Context Protocol) Server, der einem LLM (z. B. Claude Desktop) strukturierten Zugriff auf eine SQLite-Task-Datenbank gibt. Legt Aufgaben an, listet sie, aktualisiert sie und löscht sie – über vier klar definierte Tools, direkt aus dem Chat heraus steuerbar.

Funktionen

• add_task – neue Aufgabe anlegen (Titel, optionales Fälligkeitsdatum)

• list_tasks – Aufgaben auflisten, optional gefiltert nach Status (open/done)

• update_task – bestehende Aufgabe ändern (nur übergebene Felder)

• delete_task – Aufgabe löschen

Alle Tools validieren ihre Eingaben (z. B. leerer Titel, unbekannte ID, ungültiger Status) und geben verständliche Fehlermeldungen statt rohen Absturzmeldungen zurück.

Related MCP server: SQLite MCP Server

Architektur

Mcp-Server/
├── db.py          # SQLite-Zugriffslogik (kein MCP-Wissen)
├── server.py       # MCP-Tool-Definitionen, rufen nur db.py auf
├── tasks.db        # wird beim ersten Start automatisch erzeugt
├── tests/
│   └── test_db.py  # pytest-Tests für die Datenbankschicht
└── requirements.txt

Setup

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Tests ausführen

pytest tests/ -v

Einbindung in Claude Desktop

In der Datei ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) folgenden Eintrag im mcpServers-Objekt ergänzen (Pfade anpassen):

{
  "mcpServers": {
    "task-manager": {
      "command": "/absoluter/pfad/zu/Mcp-Server/venv/bin/python3",
      "args": ["/absoluter/pfad/zu/Mcp-Server/server.py"]
    }
  }
}

Danach Claude Desktop neu starten. Der Server erscheint unter Einstellungen → Entwickler → Lokale MCP-Server.

Tech-Stack

• Python 3.13

• mcp SDK (2.x, MCPServer)

• sqlite3 (Standardbibliothek)

• pytest für Tests

Status

Lernprojekt zum Einstieg in MCP-Server-Entwicklung. Design- und Implementierungsplan liegen unter docs/superpowers/.

Lizenz

MIT – siehe LICENSE.