
FastMCP Todo Server

2025.04.12
3
Python任务管理待办事项其它
FastMCP Todo Server 是一个基于 FastMCP 的待办事项服务器,专为 Swarmonomicon 项目设计。该服务器通过 FastMCP 接收待办事项请求,并将它们存储在 MongoDB 中,供 Swarmonomicon 待办事项工作器处理。
View on GitHub
Overview
基本能力
产品定位
FastMCP Todo Server 是一个用于任务管理的服务器,专门处理待办事项的接收和存储。
核心功能
- FastMCP 服务器,用于接收待办事项请求
- MongoDB 集成,用于待办事项存储
- 与 Swarmonomicon 待办事项工作器兼容
- 基于 Python 的实现
适用场景
- 任务管理和分发
- 基于代理的任务处理
- 通过 MQTT 实时更新
- 与各种 AI 模型集成
工具列表
- FastMCP Python 客户端:用于通过 FastMCP 添加待办事项
- MQTT 客户端:用于直接通过 MQTT 发布待办事项
常见问题解答
- 如何添加待办事项?可以通过 FastMCP Python 客户端或直接使用 MQTT 发布消息。
- 如何启动服务器?运行
python -m src.fastmcp_todo_server
命令。
使用教程
使用依赖
- 安装 uv(如果尚未安装):
bash curl -LsSf https://astral.sh/uv/install.sh | sh
安装教程
- 克隆仓库:
bash git clone https://github.com/DanEdens/fastmcp-todo-server.git cd fastmcp-todo-server
- 创建并激活虚拟环境:
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
调试方式
- 运行测试:
bash pytest tests/
- 运行带覆盖率的测试:
bash pytest --cov=src tests/
- 运行特定测试文件:
bash pytest tests/test_todo_handler.py -v