🚀 快速 MCP 事项服务器
快速 MCP 事项服务器是一个基于 FastMCP 的待办事项服务器，专为 Swarmonomicon 项目打造。该服务器借助 FastMCP 接收待办事项请求，并将其存储于 MongoDB 中，供 Swarmonomicon 待办事项处理程序使用。
🚀 快速开始
快速 MCP 事项服务器可高效处理待办事项请求，为 Swarmonomicon 项目提供稳定支持。以下是使用前的准备步骤：
✨ 主要特性
- 基于 FastMCP 的服务器，高效接收待办事项请求。
- 集成 MongoDB，实现待办事项的可靠存储。
- 与 Swarmonomicon 处理程序完美兼容。
- 采用 Python 实现，易于维护和扩展。
📦 安装指南
-
克隆仓库：
git clone https://github.com/DanEdens/Omnispindle.git cd Omnispindle -
安装 uv（如果尚未安装）：
curl -LsSf https://astral.sh/uv/install.sh | sh -
创建并激活带有 uv 的虚拟环境：
uv venv source .venv/bin/activate # 在 Unix/macOS 上 # 或者 .venv\Scripts\activate # 在 Windows 上 -
使用 uv 安装依赖项：
uv pip install -r requirements.txt -
开发时，安装额外的开发依赖项：
uv pip install -r requirements-dev.txt -
创建一个
.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 许可证。
🏗️ 贡献
- 叉仓库
- 创建功能分支
- 进行您的更改
- 为新功能添加测试
- 提交拉取请求
有关贡献到 Swarmonomicon 项目的主要指南，请参阅 主要项目的贡献指南。