Fastmcp Todo

🚀 快速 MCP 事项服务器

快速 MCP 事项服务器是一个基于 FastMCP 的待办事项服务器，专为 Swarmonomicon 项目打造。该服务器借助 FastMCP 接收待办事项请求，并将其存储于 MongoDB 中，供 Swarmonomicon 待办事项处理程序使用。

🚀 快速开始

快速 MCP 事项服务器可高效处理待办事项请求，为 Swarmonomicon 项目提供稳定支持。以下是使用前的准备步骤：

✨ 主要特性

• 基于 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  # 在 Unix/macOS 上
   # 或者
   .venv\Scripts\activate  # 在 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
   

💻 使用示例

基础用法

启动服务器

启动 FastMCP 服务器：

python -m src.Omnispindle

添加待办事项

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

# 使用 FastMCP Python 客户端
from fastmcp import FastMCPClient

client = FastMCPClient()
response = await client.call_tool("add_todo", {
    "description": "示例待办事项",
    "priority": "high",  # 可选，默认为 "medium"
    "target_agent": "user"  # 可选，默认为 "user"
})

# 使用 MQTT 直接发布
mosquitto_pub -t "mcp/todo/new" -m '{
    "description": "示例待办事项",
    "priority": "high",
    "target_agent": "user"
}'

高级用法

开发

运行测试：

pytest tests/

带覆盖的运行测试：

pytest --cov=src tests/

运行特定的测试文件：

pytest tests/test_todo_handler.py -v

📚 详细文档

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

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

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

📄 许可证

本项目采用 MIT 许可证。

🏗️ 贡献

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

有关贡献到 Swarmonomicon 项目的主要指南，请参阅 主要项目的贡献指南。