FastMCP 待办事项服务器

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

特征

• 用于接收待办事项请求的 FastMCP 服务器

• MongoDB 集成用于待办事项存储

• 与 Swarmonomicon 待办事项工作者兼容

• 基于Python的实现

安装

1. 克隆存储库：

   git clone https://github.com/DanEdens/Omnispindle.git cd Omnispindle

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.Omnispindle

添加待办事项

您可以通过多种方式使用 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 项目做出贡献的更多信息，请参阅主项目的贡献指南。