Microsoft Todo

🚀 微软待办事项 MCP 服务

此 MCP（模型上下文协议）服务允许您借助 AI 助手与微软待办事项任务实现交互，为您管理任务提供便捷途径。

🚀 快速开始

要使用微软待办事项 MCP 服务，需按以下步骤完成安装与配置。

📦 安装指南

1. 先决条件

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

2. 安装步骤

安装此工具分为两步：

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

步骤 1：安装包

npm install -g @jhirono/todomcp

步骤 2：设置身份验证

即便您全局安装了该软件包，仍需克隆仓库以完成身份验证过程：

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

3. Azure 应用注册

1. 访问此处进入 Azure portal。
2. 登录您的微软账户。
3. 在左侧菜单中，选择“Azure Active Directory” > “应用程序注册”。
4. 点击“新建应用程序”按钮，并填写必要信息：
   • 名称：输入您的应用名称（例如：My TodoMCP App）。
   • 支持的账户类型：选择“我的组织的目录中的账户”或“任何组织的目录和来宾访问”。
5. 填写应用注册详细信息后，点击“创建”。

4. 配置

在您克隆的仓库中创建一个 .env 文件，并添加以下内容：

CLIENT_ID=your_client_id
CLIENT_SECRET=your_client_secret
TENANT_ID=your_tenant_id

将 your_client_id、your_client_secret 和 your_tenant_id 替换为您在 Azure 应用注册中获得的相应值。

5. 使用说明

安装完成后，您需要先进行身份验证：

npm run login

遵循提示输入您的微软账户凭据。成功登录后，您可以使用以下命令列出所有可用命令：

npm run list-commands

🔧 技术细节

限制

• API 要求正确的身份验证和权限
• 根据微软的政策可能会有速率限制

故障排除

身份验证问题

• "MailboxNotEnabledForRESTAPI" 错误：此错误通常表示您使用的是个人微软账户。Microsoft 待办事项 API 通过 Graph API 对个人账户的访问权限有限。
• 令牌获取失败：请确保您的 .env 文件中的 CLIENT_ID、CLIENT_SECRET 和 TENANT_ID 是正确的。
• 权限问题：请确保您已经在 Azure 应用注册中授予了所需的权限，并且已同意组织管理员提供的行政支持。

账户类型问题

• 工作/学校账户：这些通常最适合使用待办事项 API。请使用 TENANT_ID=organizations 或您的具体租户 ID。
• 个人账户：如果必须使用个人账户，请尝试 TENANT_ID=consumers 或 TENANT_ID=common。

检查身份验证状态

您可以通过以下命令检查身份验证状态：

cat tokens.json | grep expiresAt

要将时间戳转换为可读日期：

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