FastMCP Todo Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Stores todo items in MongoDB for persistence and retrieval by the Swarmonomicon todo worker

  • Receives todo requests via MQTT protocol, allowing clients to add todos through direct MQTT messages

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/fastmcp-todo-server.git cd fastmcp-todo-server
  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.fastmcp_todo_server

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 .

-
security - not tested
F
license - not found
-
quality - not tested

Un servidor de gestión de tareas pendientes que recibe solicitudes a través de FastMCP y las almacena en MongoDB para que las procese el trabajador de tareas pendientes de Swarmonomicon.

  1. Features
    1. Installation
      1. Usage
        1. Starting the Server
        2. Adding Todos
        3. Development
      2. Integration with Swarmonomicon
        1. License
          1. Contributing
            ID: sddp91oszb