🚀 微软待办事项 MCP 服务
此 MCP（模型上下文协议）服务允许您借助 AI 助手与微软待办事项任务实现交互，为您管理任务提供便捷途径。
🚀 快速开始
要使用微软待办事项 MCP 服务，需按以下步骤完成安装与配置。
📦 安装指南
1. 先决条件
- Node.js 16 或更高版本
- npm
- 微软账户
- Azure 应用注册（见下方设置）
2. 安装步骤
安装此工具分为两步：
- 安装包
- 设置身份验证（需要克隆仓库）
步骤 1：安装包
npm install -g @jhirono/todomcp
步骤 2：设置身份验证
即便您全局安装了该软件包，仍需克隆仓库以完成身份验证过程：
git clone https://github.com/jhirono/todoMCP.git
cd todoMCP
npm install
3. Azure 应用注册
- 访问此处进入 Azure portal。
- 登录您的微软账户。
- 在左侧菜单中，选择“Azure Active Directory” > “应用程序注册”。
- 点击“新建应用程序”按钮，并填写必要信息：
- 名称：输入您的应用名称（例如：My TodoMCP App）。
- 支持的账户类型：选择“我的组织的目录中的账户”或“任何组织的目录和来宾访问”。
- 填写应用注册详细信息后，点击“创建”。
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)