FastMCP Todo Server

FastMCP Todo Server

site icon
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 发布待办请求

常见问题解答

无明确常见问题解答部分。

使用教程

使用依赖

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

安装教程

  1. 克隆仓库: bash git clone https://github.com/DanEdens/Omnispindle.git cd Omnispindle

  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. 启动 FastMCP 服务器: bash python -m src.Omnispindle

  2. 运行测试: bash pytest tests/

  3. 运行带覆盖率的测试: bash pytest --cov=src tests/

  4. 运行特定测试文件: bash pytest tests/test_todo_handler.py -v

许可证

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