# 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.

## 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

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

## Tests ausführen

```bash
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):

```json
{
  "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`](https://github.com/modelcontextprotocol/python-sdk) 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](LICENSE).