Todomcp

🚀 微軟To Do MCP服務說明

該MCP（模型上下文協議）服務允許您通過AI助手與微軟To Do任務進行交互，為用戶提供了便捷的任務管理交互方式。

🚀 快速開始

該MCP服務能讓你藉助AI助手與微軟To Do任務交互，先完成安裝和配置，即可使用相關命令進行任務操作。

📦 安裝指南

1. 先決條件

• Node.js 16或更高版本
• npm
• 微軟賬戶
• Azure應用註冊（參見下方設置說明）

2. 安裝步驟

安裝此工具包括兩部分內容：

1. 安裝包
2. 設置身份驗證（需要克隆倉庫）

第一步：安裝包

npm install -g @jhirono/todomcp

第二步：設置身份驗證

即使全局安裝了包，您仍需克隆倉庫以完成身份驗證流程：

git clone https://github.com/jhirono/todoMCP.git
cd todoMCP
npm install

3. Azure應用註冊

1. 訪問Azure Portal
2. 導航到“應用程序註冊”並創建新註冊
3. 命名您的應用程序（例如，“To Do MCP”）
4. 對於“支持的賬戶類型”，根據需求選擇以下選項之一：
   • 僅組織目錄中的賬戶 (單租戶) - 用於單一組織內部使用
   • 任何組織目錄中的賬戶 (多租戶) - 用於多個組織之間使用
   • 工作或學校賬戶 - 專門用於教育或企業環境
5. 在“應用程序身份驗證”部分，配置回話和API權限
6. 創建客戶端密鑰以獲取CLIENT_SECRET值

4. 配置指南

在項目根目錄創建一個.env文件，並添加以下內容：

CLIENT_ID=your_client_id_here
CLIENT_SECRET=your_client_secret_here
TENANT_ID=your_tenant_id_here

將your_client_id_here、your_client_secret_here和your_tenant_id_here替換為從Azure註冊的實際值。

5. 使用說明

安裝完成後，您可以通過以下命令使用MCP工具：

mcp --help

這將顯示所有可用命令及其詳細選項。有關特定命令的用法，請參考文檔。

💻 使用示例

基礎用法

安裝完成後，查看幫助信息：

mcp --help

高級用法

獲取所有任務：

mcp list-tasks

📚 詳細文檔

可用工具

以下是您可以使用的完整命令列表：

• list-tasks: 獲取所有任務
• get-task: 獲取單個任務的詳細信息
• create-task: 創建新任務
• update-task: 更新現有任務
• delete-task: 刪除指定任務
• list-categories: 獲取所有類別
• get-category: 獲取單個類別的詳細信息
• create-category: 創建新類別
• update-category: 更新現有類別
• delete-category: 刪除指定類別

限制與注意事項

• API需要正確的身份驗證和權限
• 微軟策略可能會有速率限制

故障排除

身份驗證問題

• "MailboxNotEnabledForRESTAPI" 錯誤：通常表示使用的是個人微軟賬戶。通過Graph API訪問To Do API對個人賬戶有限制。
• 令牌獲取失敗：請確保.env文件中的CLIENT_ID、CLIENT_SECRET和TENANT_ID正確無誤。
• 權限問題：請確認在Azure應用註冊中已授予所需的管理同意權限。

賬戶類型問題

• 工作/學校賬戶：這些通常最適合使用To Do API。請使用TENANT_ID=organizations或您的特定租戶ID。
• 個人賬戶：這些對To Do API的訪問受到限制。如果您必須使用個人賬戶，請嘗試TENANT_ID=consumers或TENANT_ID=common。

檢查身份驗證狀態

您可以使用auth-status工具檢查身份驗證狀態，或通過查看令牌的有效期時間：

cat tokens.json | grep expiresAt

要將時間戳轉換為可讀日期：

date -r $(echo "$(cat tokens.json | grep expiresAt | cut -d ":" -f2 | cut -d "," -f1) / 1000" | bc)

⚠️ 重要提示

API需要正確的身份驗證和權限，微軟策略可能會有速率限制。

💡 使用建議

若遇到身份驗證問題，可按文檔中的故障排除方法進行解決；使用工作或學校賬戶通常能更好地使用To Do API。