Mail MCP Tool

Implementation Reference

• src/tools/mail.ts:313-349 (handler)

  Handler function for the 'sendSimpleMail' MCP tool. It validates input using Zod schema, calls MailService.sendMail with to, subject, and text=body, and returns success/error response.
  this.server.tool( "sendSimpleMail", { to: z.string(), subject: z.string(), body: z.string() }, async ({ to, subject, body }) => { try { const result = await this.mailService.sendMail({ to, subject, text: body }); if (result.success) { return { content: [ { type: "text", text: `简单邮件发送成功，消息ID: ${result.messageId}\n\n提示：如果需要等待对方回复，可以使用 waitForReply 工具。` } ] }; } else { return { content: [ { type: "text", text: `简单邮件发送失败: ${result.error}` } ] }; } } catch (error) { return { content: [ { type: "text", text: `发送简单邮件时发生错误: ${error instanceof Error ? error.message : String(error)}` } ] }; } } );
• src/tools/mail.ts:316-318 (schema)

  Zod input schema for sendSimpleMail tool: requires 'to' (string), 'subject' (string), 'body' (string).
  to: z.string(), subject: z.string(), body: z.string()
• src/tools/mail-service.ts:156-178 (helper)

  MailService.sendMail method: the core implementation that uses nodemailer Transporter to send the email based on MailInfo.
  async sendMail(mailInfo: MailInfo): Promise<{ success: boolean; messageId?: string; error?: string }> { try { const mailOptions = { from: { name: this.config.defaults.fromName, address: this.config.defaults.fromEmail, }, to: mailInfo.to, cc: mailInfo.cc, bcc: mailInfo.bcc, subject: mailInfo.subject, text: mailInfo.text, html: mailInfo.html, attachments: mailInfo.attachments, }; const info = await this.smtpTransporter.sendMail(mailOptions); return { success: true, messageId: info.messageId }; } catch (error) { console.error('发送邮件错误:', error); return { success: false, error: error instanceof Error ? error.message : String(error) }; } }
• src/tools/mail-service.ts:34-46 (schema)

  TypeScript interface MailInfo defining the structure for email sending parameters, used by sendMail.
  export interface MailInfo { to: string | string[]; cc?: string | string[]; bcc?: string | string[]; subject: string; text?: string; html?: string; attachments?: Array<{ filename: string; content: string | Buffer; contentType?: string; }>; }