FastMCP Todo Server

Ein FastMCP-basierter To-do-Server für das Swarmonomicon- Projekt. Dieser Server empfängt To-do-Anfragen über FastMCP und speichert sie in MongoDB zur Verarbeitung durch den Swarmonomicon-Todo-Worker.

Merkmale

FastMCP-Server zum Empfangen von To-Do-Anfragen
MongoDB-Integration für die Aufgabenspeicherung
Kompatibel mit Swarmonomicon Todo Worker
Python-basierte Implementierung

Related MCP server: Coding Todo Server

Installation

Klonen Sie das Repository:

git clone https://github.com/DanEdens/Omnispindle.git
cd Omnispindle

Installieren Sie uv (falls noch nicht installiert):
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```

Erstellen und aktivieren Sie eine virtuelle Umgebung mit UV:

uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows

Installieren Sie Abhängigkeiten mit uv:
```
uv pip install -r requirements.txt
```
Installieren Sie für die Entwicklung zusätzliche Abhängigkeiten:
```
uv pip install -r requirements-dev.txt
```

Erstellen Sie eine .env Datei mit Ihrer Konfiguration:

MONGODB_URI=mongodb://localhost:27017
MONGODB_DB=swarmonomicon
MONGODB_COLLECTION=todos

Verwendung

Starten des Servers

Starten Sie den FastMCP-Server:
```
python -m src.Omnispindle
```

Todos hinzufügen

Sie können mit FastMCP auf verschiedene Arten Aufgaben hinzufügen:

Verwenden des FastMCP Python-Clients:

from fastmcp import FastMCPClient

client = FastMCPClient()
response = await client.call_tool("add_todo", {
    "description": "Example todo",
    "priority": "high",  # optional, defaults to "medium"
    "target_agent": "user"  # optional, defaults to "user"
})

Direkte Verwendung von MQTT:

mosquitto_pub -t "mcp/todo/new" -m '{
    "description": "Example todo",
    "priority": "high",
    "target_agent": "user"
}'

Entwicklung

Führen Sie Tests durch:
```
pytest tests/
```
Führen Sie Tests mit Abdeckung durch:
```
pytest --cov=src tests/
```
Führen Sie eine bestimmte Testdatei aus:
```
pytest tests/test_todo_handler.py -v
```