微软待办事项 MCP 服务

此MCP（模型上下文协议）服务允许您通过AI助手与微软待办事项任务进行交互。

安装说明

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)