Fastmcp Todo

🚀 快速 MCP 待辦事項服務器

快速 MCP 待辦事項服務器是基於 FastMCP 構建的，專為 Swarmonomicon 項目打造。它能夠接收待辦事項請求，並將其存儲在 MongoDB 中，供 Swarmonomicon 待辦事項處理程序進行後續處理，極大地提升了待辦事項管理的效率。

🚀 快速開始

此服務器是基於 FastMCP 的待辦事項管理解決方案，藉助 FastMCP 接收請求，並將數據存儲於 MongoDB，與 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 系統上
   # 或者在 Windows 上
   .venv\Scripts\activate
   

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/

高級用法

運行帶有覆蓋率的測試：

coverage run -m pytest tests/ && coverage report

指定運行特定測試文件：

pytest tests/test_example.py -v

📚 詳細文檔

此服務器在 Swarmonomicon 生態系統中扮演重要角色，具體信息請參閱主項目文檔：Swarmonomicon。

📄 許可證

該項目的許可信息在此處說明，請查閱相關文件以獲取詳細信息。

🤝 貢獻指南

歡迎社區貢獻！如需參與，請參考項目的貢獻指南，瞭解如何提交問題、拉取請求和參與開發。