🚀 微软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。