
FastMCP Todo Server

2025.04.20
3
Python任务管理代理处理其它
Omnispindle 是一个基于 FastMCP 的待办事项服务器,专为 Swarmonomicon 项目设计。该服务器通过 FastMCP 接收待办请求,并将它们存储在 MongoDB 中,供 Swarmonomicon 待办工作器处理。
View on GitHub
Overview
基本能力
产品定位
Omnispindle 是一个基于 FastMCP 的待办事项服务器,用于接收和处理待办请求,并与 MongoDB 集成进行数据存储。
核心功能
- FastMCP 服务器,用于接收待办请求
- MongoDB 集成,用于待办事项存储
- 与 Swarmonomicon 待办工作器兼容
- 基于 Python 的实现
适用场景
- 任务管理和分发
- 基于代理的任务处理
- 通过 MQTT 进行实时更新
- 与各种 AI 模型集成
工具列表
- FastMCP Python 客户端:用于调用待办事项添加功能
- MQTT 客户端:用于直接通过 MQTT 发布待办请求
常见问题解答
无明确常见问题解答部分。
使用教程
使用依赖
- 安装 uv(如果尚未安装):
bash curl -LsSf https://astral.sh/uv/install.sh | sh
安装教程
-
克隆仓库:
bash git clone https://github.com/DanEdens/Omnispindle.git cd Omnispindle
-
创建并激活虚拟环境:
bash uv venv source .venv/bin/activate # On Unix/macOS # or .venv\Scripts\activate # On Windows
-
安装依赖:
bash uv pip install -r requirements.txt
-
开发环境额外依赖:
bash uv pip install -r requirements-dev.txt
-
创建
.env
文件:bash MONGODB_URI=mongodb://localhost:27017 MONGODB_DB=swarmonomicon MONGODB_COLLECTION=todos
调试方式
-
启动 FastMCP 服务器:
bash python -m src.Omnispindle
-
运行测试:
bash pytest tests/
-
运行带覆盖率的测试:
bash pytest --cov=src tests/
-
运行特定测试文件:
bash pytest tests/test_todo_handler.py -v