Mail MCP Tool

Implementation Reference

• src/tools/mail.ts:1068-1093 (handler)

  The inline handler function for the MCP tool 'markMultipleAsRead'. It validates inputs, calls the mail service to mark emails as read, and returns a success or error message.

  async ({ uids, folder }) => {
    try {
      const numericUids = uids.map(uid => Number(uid));
      const success = await this.mailService.markMultipleAsRead(numericUids, folder);
      
      if (success) {
        return {
          content: [
            { type: "text", text: `已将 ${uids.length} 封邮件标记为已读` }
          ]
        };
      } else {
        return {
          content: [
            { type: "text", text: `批量标记邮件为已读失败` }
          ]
        };
      }
    } catch (error) {
      return {
        content: [
          { type: "text", text: `批量标记邮件为已读时发生错误: ${error instanceof Error ? error.message : String(error)}` }
        ]
      };
    }
  }

• src/tools/mail.ts:1064-1067 (schema)

  Zod schema defining the input parameters for the 'markMultipleAsRead' tool: array of numeric UIDs and optional folder.

  {
    uids: z.array(z.number()),
    folder: z.string().default('INBOX')
  },

• src/tools/mail.ts:1062-1094 (registration)

  Registration of the 'markMultipleAsRead' tool on the MCP server, including schema and handler.

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

• src/tools/mail-service.ts:1068-1090 (helper)

  Helper method in MailService class that performs the actual IMAP operation to mark multiple emails as read by adding the \Seen flag.

  async markMultipleAsRead(uids: (number | string)[], folder: string = 'INBOX'): Promise<boolean> {
    await this.connectImap();
    
    // 确保所有 uid 都是数字类型
    const numericUids = uids.map(uid => 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.addFlags(numericUids, '\\Seen', (err) => {
          if (err) {
            reject(err);
            return;
          }
          resolve(true);
        });
      });
    });
  }