FastMCP Todo Server

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

Installation

1. Klonen Sie das Repository:
   git clone https://github.com/DanEdens/Omnispindle.git cd Omnispindle
2. Installieren Sie uv (falls noch nicht installiert):
   curl -LsSf https://astral.sh/uv/install.sh | sh
3. Erstellen und aktivieren Sie eine virtuelle Umgebung mit UV:
   uv venv source .venv/bin/activate # On Unix/macOS # or .venv\Scripts\activate # On Windows
4. Installieren Sie Abhängigkeiten mit uv:
   uv pip install -r requirements.txt
5. Installieren Sie für die Entwicklung zusätzliche Abhängigkeiten:
   uv pip install -r requirements-dev.txt
6. Erstellen Sie eine .env Datei mit Ihrer Konfiguration:
   MONGODB_URI=mongodb://localhost:27017 MONGODB_DB=swarmonomicon MONGODB_COLLECTION=todos

Verwendung

Starten des Servers

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

Todos hinzufügen

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

1. 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" })
2. Direkte Verwendung von MQTT:
   mosquitto_pub -t "mcp/todo/new" -m '{ "description": "Example todo", "priority": "high", "target_agent": "user" }'

Entwicklung

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

Integration mit Swarmonomicon

Dieser Server ist Teil des größeren Swarmonomicon -Projekts, das Folgendes bietet:

• Aufgabenverwaltung und -verteilung
• Agentenbasierte Aufgabenverarbeitung
• Echtzeit-Updates über MQTT
• Integration mit verschiedenen KI-Modellen

Weitere Informationen zum Swarmonomicon-Projekt und seinen Funktionen finden Sie in der Hauptprojektdokumentation .

Lizenz

MIT-Lizenz

Beitragen

1. Forken Sie das Repository
2. Erstellen eines Feature-Zweigs
3. Nehmen Sie Ihre Änderungen vor
4. Fügen Sie Tests für neue Funktionen hinzu
5. Senden einer Pull-Anfrage

Weitere Informationen zum Mitwirken am Swarmonomicon-Projekt finden Sie in den Beitragsrichtlinien des Hauptprojekts .