Fastmcp Todo Server

🚀 Fast MCP To-Do Server

A to-do server based on FastMCP, designed for the Swarmonomicon project. This server receives to-do requests via FastMCP and stores them in MongoDB for use by the Swarmonomicon to-do handler.

✨ Features

• A FastMCP-based server for receiving to-do requests.
• To-do storage integrated with MongoDB.
• Compatibility with the Swarmonomicon to-do handler.
• Implemented in Python.

📦 Installation

1. Clone the repository:

   git clone https://github.com/DanEdens/Omnispindle.git
   cd Omnispindle
   

2. Install uv (if not already installed):

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

3. Create and activate a virtual environment with uv:

   uv venv
   source .venv/bin/activate  # On Unix/macOS systems
   # Or
   .venv\Scripts\activate  # On Windows systems
   

4. Install dependencies using uv:

   uv pip install -r requirements.txt
   

5. For the development environment, install additional dependencies:

   uv pip install -r requirements-dev.txt
   

6. Create a configuration file .env:

   MONGODB_URI=mongodb://localhost:27017
   MONGODB_DB=swarmonomicon
   MONGODB_COLLECTION=todos
   

💻 Usage Examples

Basic Usage - Start the Server

1. Start the FastMCP server:

   python -m src.Omnispindle
   

Advanced Usage - Add a To-Do Item

You can add to-do items through FastMCP in multiple ways:

Using the FastMCP Python Client

from fastmcp import FastMCPClient

client = FastMCPClient()
response = await client.call_tool("add_todo", {
    "description": "Example to-do item",
    "priority": "high",  # Optional, default is "medium"
    "target_agent": "user"  # Optional, default is "user"
})

Using MQTT Directly

mosquitto_pub -t "mcp/todo/new" -m '{
    "description": "Example to-do item",
    "priority": "high",
    "target_agent": "user"
}'

Development

1. Run tests:

   pytest tests/
   

2. Run tests with coverage:

   pytest --cov=src tests/
   

3. Run a specific test file:

   pytest tests/test_todo_handler.py -v
   

📚 Documentation

This server is part of the larger Swarmonomicon project, which offers:

• Task management and assignment.
• Agent-based task processing.
• Real-time updates via MQTT.
• Integration of multiple AI models.

For more detailed information about the Swarmonomicon project, please refer to the main project documentation.

📄 License

This project is under the MIT License.

Contribution

1. Fork the repository.
2. Create a feature branch.
3. Make your modifications.
4. Add tests for new features.
5. Submit a pull request.

For more information on how to contribute to the Swarmonomicon project, please refer to the main project contribution guide.