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 .