Mail MCP Tool

Implementation Reference

• src/tools/mail.ts:1167-1199 (registration)

  MCP tool registration for 'markAsUnread', including Zod input schema {uid: number, folder?: string}, handler function that calls MailService.markAsUnread and returns formatted response.

  this.server.tool(
    "markAsUnread",
    {
      uid: z.number(),
      folder: z.string().default('INBOX')
    },
    async ({ uid, folder }) => {
      try {
        const numericUid = Number(uid);
        const success = await this.mailService.markAsUnread(numericUid, folder);
        
        if (success) {
          return {
            content: [
              { type: "text", text: `邮件(UID: ${uid})已标记为未读` }
            ]
          };
        } else {
          return {
            content: [
              { type: "text", text: `标记邮件(UID: ${uid})为未读失败` }
            ]
          };
        }
      } catch (error) {
        return {
          content: [
            { type: "text", text: `标记邮件为未读时发生错误: ${error instanceof Error ? error.message : String(error)}` }
          ]
        };
      }
    }
  );

• src/tools/mail-service.ts:545-567 (helper)

  MailService method that implements the core logic: opens IMAP box and removes the \\Seen flag from the specified email UID using delFlags.

  async markAsUnread(uid: number | string, folder: string = 'INBOX'): Promise<boolean> {
    await this.connectImap();
    
    // 确保 uid 为数字类型
    const numericUid = typeof uid === 'string' ? parseInt(uid, 10) : uid;
  
    return new Promise((resolve, reject) => {
      this.imapClient.openBox(folder, false, (err) => {
        if (err) {
          reject(err);
          return;
        }
  
        this.imapClient.delFlags(numericUid, '\\Seen', (err) => {
          if (err) {
            reject(err);
            return;
          }
          resolve(true);
        });
      });
    });
  }