To Do MCP Server

🚀 使用 MCP 服務器構建的 Todo 應用

這是一個簡單的 Todo 應用程序，它集成了自然語言處理（藉助 Google Gemini API）、MongoDB 持久化存儲以及 MCP 協議（用於即時更新的 Server-Sent Events），並基於 Express.js 採用模塊化的 MVC 架構構建而成，能為用戶提供便捷的待辦事項管理體驗。

✨ 主要特性

• 自然語言交互：可使用自然語言添加待辦事項，例如“Add a task to buy milk”。
• 靈活列表展示：能列出所有待辦事項，還可選擇包含已完成的項。
• 便捷任務操作：可根據 MongoDB ID 將待辦事項標記為完成，也能通過 MongoDB ID 刪除待辦事項。
• 即時更新體驗：通過 Server-Sent Events (SSE) 和 MCP 協議接收即時更新。

📦 安裝指南

先決條件

• Node.js（v18 或更高版本）
• MongoDB Atlas 集群（需要憑證）
• Google Gemini API Key（從 Google AI Studio 獲取）

安裝步驟

1. 克隆倉庫

   git clone https://github.com/theatulanand/to-do-mcp-server.git
   cd todo-mcp-single
   

2. 安裝依賴項

   npm install
   

3. 設置環境變量

   在根目錄下創建一個 .env 文件：

   PORT=3000
   MONGO_URI=URI
   GEMINI_API_KEY=
   

💻 使用示例

運行應用程序

啟動服務器：

npm start

你應該會看到：

連接到 MongoDB（通過 Mongoose）
服務器運行在 http://localhost:3000

要停止服務器，請按 Ctrl + C。

發送請求

向 /api/command 發送 POST 請求，請求體為 JSON 格式：

{ "command": "Add a task to buy milk" }

示例命令

• 添加：

  curl -X POST http://localhost:3000/api/command -H "Content-Type: application/json" -d '{"command": "Add a task to buy milk"}'
  

• 列出：

  curl -X POST http://localhost:3000/api/command -H "Content-Type: application/json" -d '{"command": "List my todos"}'
  

• 完成：

  curl -X POST http://localhost:3000/api/command -H "Content-Type: application/json" -d '{"command": "Complete todo with ID some_mongodb_id"}'
  

• 刪除：

  curl -X POST http://localhost:3000/api/command -H "Content-Type: application/json" -d '{"command": "Delete todo with ID some_mongodb_id"}'
  

• 列出包含已完成的項：

  curl -X POST http://localhost:3000/api/command -H "Content-Type: application/json" -d '{"command": "List my todos including completed"}'
  

即時更新（SSE）

連接到 /sse 以接收即時更新。（需要 MCP 兼容客戶端。）

🔧 技術細節

技術棧

項目結構

todo-mcp-single/
├── models/           # Mongoose 模型
│   └── Todo.js
├── controllers/      # 業務邏輯
│   └── todoController.js
├── routes/           # API 路由
│   └── todoRoutes.js
├── utils/            # 工具函數（例如：與 Gemini 的交互）
└── index.js          # 應用程序入口文件

📄 注意事項

⚠️ 重要提示

請確保 MongoDB 連接字符串 (MONGO_URI) 和 Google Gemini API Key 配置正確。

💡 使用建議

如果需要處理大量數據或高併發請求，建議進行適當的性能優化和負載均衡配置。

通過以上步驟，你可以輕鬆搭建一個功能完善的 Todo 應用程序，並利用 MCP 協議實現即時更新。