FastMCP Todo Server

Servidor Todo FastMCP

Un servidor de tareas pendientes basado en FastMCP para el proyecto Swarmonomicon . Este servidor recibe solicitudes de tareas pendientes mediante FastMCP y las almacena en MongoDB para que el trabajador de tareas pendientes de Swarmonomicon las procese.

Características

• Servidor FastMCP para recibir solicitudes de tareas pendientes
• Integración de MongoDB para el almacenamiento de tareas pendientes
• Compatible con el trabajador de tareas pendientes de Swarmonomicon
• Implementación basada en Python

Instalación

1. Clonar el repositorio:
   git clone https://github.com/DanEdens/Omnispindle.git cd Omnispindle
2. Instalar uv (si aún no está instalado):
   curl -LsSf https://astral.sh/uv/install.sh | sh
3. Crear y activar un entorno virtual con uv:
   uv venv source .venv/bin/activate # On Unix/macOS # or .venv\Scripts\activate # On Windows
4. Instalar dependencias con uv:
   uv pip install -r requirements.txt
5. Para el desarrollo, instale dependencias adicionales:
   uv pip install -r requirements-dev.txt
6. Crea un archivo .env con tu configuración:
   MONGODB_URI=mongodb://localhost:27017 MONGODB_DB=swarmonomicon MONGODB_COLLECTION=todos

Uso

Iniciando el servidor

1. Inicie el servidor FastMCP:
   python -m src.Omnispindle

Agregar tareas pendientes

Puedes agregar tareas pendientes usando FastMCP de varias maneras:

1. Usando el cliente Python FastMCP:
   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. Usando MQTT directamente:
   mosquitto_pub -t "mcp/todo/new" -m '{ "description": "Example todo", "priority": "high", "target_agent": "user" }'

Desarrollo

1. Ejecutar pruebas:
   pytest tests/
2. Ejecutar pruebas con cobertura:
   pytest --cov=src tests/
3. Ejecutar archivo de prueba específico:
   pytest tests/test_todo_handler.py -v

Integración con Swarmonomicon

Este servidor es parte del proyecto más grande Swarmonomicon , que proporciona:

• Gestión y distribución de tareas
• Procesamiento de tareas basado en agentes
• Actualizaciones en tiempo real a través de MQTT
• Integración con varios modelos de IA

Para obtener más información sobre el proyecto Swarmonomicon y sus características, consulte la documentación principal del proyecto .

Licencia

Licencia MIT

Contribuyendo

1. Bifurcar el repositorio
2. Crear una rama de características
3. Realiza tus cambios
4. Agregar pruebas para nuevas funcionalidades
5. Enviar una solicitud de extracción

Para obtener más información sobre cómo contribuir al proyecto Swarmonomicon, consulte las pautas de contribución del proyecto principal .