FastMCP 待办事项服务器

Swarmonomicon项目基于 FastMCP 的 Todo 服务器。该服务器通过 FastMCP 接收 Todo 请求，并将其存储在 MongoDB 中，以供 Swarmonomicon Todo 工作器处理。

特征

• 用于接收待办事项请求的 FastMCP 服务器
• MongoDB 集成用于待办事项存储
• 与 Swarmonomicon 待办事项工作者兼容
• 基于Python的实现

安装

1. 克隆存储库：
   git clone https://github.com/DanEdens/fastmcp-todo-server.git cd fastmcp-todo-server
2. 安装 uv（如果尚未安装）：
   curl -LsSf https://astral.sh/uv/install.sh | sh
3. 使用 uv 创建并激活虚拟环境：
   uv venv source .venv/bin/activate # On Unix/macOS # or .venv\Scripts\activate # On Windows
4. 使用 uv 安装依赖项：
   uv pip install -r requirements.txt
5. 为了开发，请安装其他依赖项：
   uv pip install -r requirements-dev.txt
6. 使用您的配置创建一个.env文件：
   MONGODB_URI=mongodb://localhost:27017 MONGODB_DB=swarmonomicon MONGODB_COLLECTION=todos

用法

启动服务器

1. 启动 FastMCP 服务器：
   python -m src.fastmcp_todo_server

添加待办事项

您可以通过多种方式使用 FastMCP 添加待办事项：

1. 使用 FastMCP Python 客户端：
   from fastmcp import FastMCPClient client = FastMCPClient() response = await client.call_tool("add_todo", { "description": "Example todo", "priority": "high", # optional, defaults to "medium" "target_agent": "user" # optional, defaults to "user" })
2. 直接使用 MQTT：
   mosquitto_pub -t "mcp/todo/new" -m '{ "description": "Example todo", "priority": "high", "target_agent": "user" }'

发展

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

与 Swarmonomicon 集成

该服务器是更大的Swarmonomicon项目的一部分，该项目提供：

• 任务管理和分配
• 基于代理的任务处理
• 通过 MQTT 实时更新
• 与各种AI模型集成

有关 Swarmonomicon 项目及其功能的更多信息，请查看主要项目文档。

执照

MIT 许可证

贡献

1. 分叉存储库
2. 创建功能分支
3. 进行更改
4. 添加新功能测试
5. 提交拉取请求

有关为 Swarmonomicon 项目做出贡献的更多信息，请参阅主项目的贡献指南。