FastMCP Todo Server

FastMCP Todo Server

site icon
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 命令。

使用教程

使用依赖

  1. 安装 uv(如果尚未安装): bash curl -LsSf https://astral.sh/uv/install.sh | sh

安装教程

  1. 克隆仓库: bash git clone https://github.com/DanEdens/fastmcp-todo-server.git cd fastmcp-todo-server
  2. 创建并激活虚拟环境: bash uv venv source .venv/bin/activate # On Unix/macOS # or .venv\Scripts\activate # On Windows
  3. 安装依赖: bash uv pip install -r requirements.txt
  4. 开发环境额外依赖: bash uv pip install -r requirements-dev.txt
  5. 创建 .env 文件: bash MONGODB_URI=mongodb://localhost:27017 MONGODB_DB=swarmonomicon MONGODB_COLLECTION=todos

调试方式

  1. 运行测试: bash pytest tests/
  2. 运行带覆盖率的测试: bash pytest --cov=src tests/
  3. 运行特定测试文件: bash pytest tests/test_todo_handler.py -v

许可证

该项目遵循 MIT 开源许可条款。