Integrates with MongoDB and MQTT to enable real-time task management, distribution, and updates for collaborative workfl...
Created byApr 23, 2025
FastMCP Todo Server
A FastMCP-based Todo Server for the [Swarmonomicon](https://github.com/DanEdens/madness_interactive/tree/main/projects/common/Swarmonomicon) project. This server receives todo requests via FastMCP and stores them in MongoDB for processing by the Swarmonomicon todo worker.
Features
FastMCP server for receiving todo requests
MongoDB integration for todo storage
Compatible with Swarmonomicon todo worker
Python-based implementation
Installation
Clone the repository:
```bash
git clone https://github.com/DanEdens/Omnispindle.git
cd Omnispindle
```
Install uv (if not already installed):
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
Create and activate a virtual environment with uv:
```bash
uv venv
source .venv/bin/activate # On Unix/macOS
# or
.venv\Scripts\activate # On Windows
```
Run tests with coverage:
```bash
pytest --cov=src tests/
```
Run specific test file:
```bash
pytest tests/test_todo_handler.py -v
```
Integration with Swarmonomicon
This server is part of the larger [Swarmonomicon](https://github.com/DanEdens/madness_interactive/tree/main/projects/common/Swarmonomicon) project, which provides:
Task management and distribution
Agent-based task processing
Real-time updates via MQTT
Integration with various AI models
For more information about the Swarmonomicon project and its features, check out the [main project documentation](https://github.com/DanEdens/madness_interactive/tree/main/projects/common/Swarmonomicon/README.md).
License
MIT License
Contributing
Fork the repository
Create a feature branch
Make your changes
Add tests for new functionality
Submit a pull request
For more information about contributing to the Swarmonomicon project, see the [main project's contributing guidelines](https://github.com/DanEdens/madness_interactive/tree/main/projects/common/Swarmonomicon/CONTRIBUTING.md).