JinDaGe - todoMCP MCP Details

article

README

🚀 微软To Do MCP服务说明

该MCP（模型上下文协议）服务允许您通过AI助手与微软To Do任务进行交互，为用户提供了便捷的任务管理交互方式。

🚀 快速开始

该MCP服务能让你借助AI助手与微软To Do任务交互，先完成安装和配置，即可使用相关命令进行任务操作。

📦 安装指南

1. 先决条件

Node.js 16或更高版本
npm
微软账户
Azure应用注册（参见下方设置说明）

2. 安装步骤

安装此工具包括两部分内容：

安装包
设置身份验证（需要克隆仓库）

第一步：安装包

npm install -g @jhirono/todomcp

第二步：设置身份验证

即使全局安装了包，您仍需克隆仓库以完成身份验证流程：

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

3. Azure应用注册

访问Azure Portal
导航到“应用程序注册”并创建新注册
命名您的应用程序（例如，“To Do MCP”）
对于“支持的账户类型”，根据需求选择以下选项之一：
- 仅组织目录中的账户 (单租户) - 用于单一组织内部使用
- 任何组织目录中的账户 (多租户) - 用于多个组织之间使用
- 工作或学校账户 - 专门用于教育或企业环境
在“应用程序身份验证”部分，配置回话和API权限
创建客户端密钥以获取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。

todoMCP