To Do List MCP Server

🚀 待辦事項列表 MCP 服務器

這是一個基於 Model Context Protocol (MCP) 實現的簡單待辦事項管理器，藉助 MCP 工具可進行基本的 CRUD 操作，為用戶提供便捷的待辦事項管理體驗。

🚀 快速開始

本待辦事項列表 MCP 服務器能讓你輕鬆管理待辦事項。下面為你介紹如何快速開啟使用。

✨ 主要特性

• 待辦事項操作：支持添加新的待辦事項、查看所有待辦事項以及根據 ID 刪除待辦事項。
• 類型安全：使用 Zod 驗證實現類型安全操作。
• 存儲方式：採用簡單的內存存儲。
• 傳輸方式：具備便於集成的 Stdio 傳輸。

📦 安裝指南

在項目中安裝所需依賴，執行以下命令：

npm install @modelcontextprotocol/sdk zod

💻 使用示例

基礎用法

運行服務器：

npm run start

高級用法

可用工具及其使用說明：

1. add-todo：添加一個新的待辦事項。

   • 參數：{text: string}
   • 返回成功消息及分配的 ID

2. get-todos：獲取所有待辦事項。

   • 返回格式化的待辦事項列表或空狀態消息

3. remove-todo：刪除一個待辦事項。

   • 參數：{id: number}
   • 返回刪除成功的消息，如果未找到 ID 則返回錯誤

以下是代碼示例：

// 添加一個新的待辦事項
await client.callTool({
    name: "add-todo",
    arguments: { text: "購買雜貨" }
});

// 獲取所有待辦事項
await client.callTool({ name: "get-todos" });

// 刪除一個待辦事項
await client.callTool({
    name: "remove-todo",
    arguments: { id: 1 }
});

🔧 技術細節

• 協議合規：使用 MCP 服務器 SDK 確保協議合規。
• 操作模式：實現工具模式進行操作。
• 通信方式：使用 Stdio 傳輸進行通信。
• 狀態維護：在內存中維護狀態以確保簡單性。

📚 詳細文檔

使用 MCP 客戶端（如 claude）測試服務器的步驟如下：

1. 運行服務器。
2. 使用 MCP 檢查器連接。
3. 分別測試每個工具。
4. 驗證響應和錯誤處理。