Email MCP Server

Instructions

Implementation Reference

• index.js:1018-1040 (handler)

  The primary handler function for the 'list_supported_providers' tool. It generates a formatted list of all supported email providers from the EMAIL_CONFIGS constant, including names, domains, recommended protocols, and usage instructions.

  async listSupportedProviders() {
    let result = `📋 支持的邮箱提供商:\n\n`;
    
    for (const [provider, config] of Object.entries(EMAIL_CONFIGS)) {
      result += `🏢 ${config.name} (${provider})\n`;
      result += `   域名: ${config.domains.join(', ')}\n`;
      result += `   推荐协议: ${config.usePOP3 ? 'POP3' : 'IMAP'}\n`;
      result += `   示例: user@${config.domains[0]}\n\n`;
    }
  
    result += `💡 使用方法:\n`;
    result += `1. 使用 setup_email_account 工具\n`;
    result += `2. 填写完整邮箱地址和密码/授权码\n`;
    result += `3. 系统会自动识别并配置对应的邮箱服务器\n\n`;
    result += `⚠️  注意: 请确保已在对应邮箱中开启POP3/IMAP/SMTP服务并获取授权码！`;
  
    return {
      content: [{
        type: 'text',
        text: result
      }]
    };
  }

• index.js:270-278 (registration)

  Tool registration in the ListToolsRequestSchema handler. Defines the tool name, description, and empty input schema (no parameters required).

  {
    name: 'list_supported_providers',
    description: '列出支持的邮箱提供商',
    inputSchema: {
      type: 'object',
      properties: {},
      required: []
    }
  },

• index.js:273-277 (schema)

  Input schema for the 'list_supported_providers' tool, specifying an empty object (no input parameters needed).

  inputSchema: {
    type: 'object',
    properties: {},
    required: []
  }

• index.js:16-91 (helper)

  The EMAIL_CONFIGS constant defining all supported email providers' configurations (servers, domains, protocols), which is used by the listSupportedProviders handler to generate the list.

  const EMAIL_CONFIGS = {
    'qq': {
      name: 'QQ邮箱',
      domains: ['qq.com'],
      smtp: { host: 'smtp.qq.com', port: 587, secure: false },
      imap: { host: 'imap.qq.com', port: 993, secure: true },
      pop3: { host: 'pop.qq.com', port: 995, secure: true },
      usePOP3: false
    },
    '163': {
      name: '网易邮箱',
      domains: ['163.com', '126.com', 'yeah.net'],
      smtp: { host: 'smtp.163.com', port: 465, secure: true },
      imap: { host: 'imap.163.com', port: 993, secure: true },
      pop3: { host: 'pop.163.com', port: 995, secure: true },
      usePOP3: true // 163邮箱推荐使用POP3
    },
    // 'netease-enterprise': {
    //   name: '网易企业邮箱',
    //   domains: [], // 企业域名不固定
    //   smtp: { host: 'smtphz.qiye.163.com', port: 587, secure: false }, // 使用587端口和STARTTLS
    //   imap: { host: 'imaphz.qiye.163.com', port: 993, secure: true },
    //   pop3: { host: 'pophz.qiye.163.com', port: 995, secure: true },
    //   usePOP3: true // 网易企业邮箱推荐使用POP3
    // },
    'gmail': {
      name: 'Gmail',
      domains: ['gmail.com', 'googlemail.com'],
      smtp: { host: 'smtp.gmail.com', port: 587, secure: true }, // 从2025年5月1日起，需要OAuth认证
      imap: { host: 'imap.gmail.com', port: 993, secure: true },
      pop3: { host: 'pop.gmail.com', port: 995, secure: true },
      usePOP3: false, // Gmail推荐使用IMAP
      requiresOAuth: true, // 2025年5月1日后必须使用OAuth，不支持密码认证
      note: '需要在Gmail设置中启用POP/IMAP，Google Workspace需要管理员启用'
    },
    'outlook': {
      name: 'Outlook/Hotmail',
      domains: ['outlook.com', 'hotmail.com', 'live.com', 'msn.com'],
      smtp: { host: 'smtp-mail.outlook.com', port: 587, secure: false },
      imap: { host: 'outlook.office365.com', port: 993, secure: true },
      pop3: { host: 'outlook.office365.com', port: 995, secure: true },
      usePOP3: false
    },
    'exmail': {
      name: '腾讯企业邮箱',
      domains: ['exmail.qq.com'],
      smtp: { host: 'smtp.exmail.qq.com', port: 465, secure: true },
      imap: { host: 'imap.exmail.qq.com', port: 993, secure: true },
      pop3: { host: 'pop.exmail.qq.com', port: 995, secure: true },
      usePOP3: false
    },
    'aliyun': {
      name: '阿里云邮箱',
      domains: ['aliyun.com', 'alibaba-inc.com'],
      smtp: { host: 'smtp.mxhichina.com', port: 465, secure: true },
      imap: { host: 'imap.mxhichina.com', port: 993, secure: true },
      pop3: { host: 'pop.mxhichina.com', port: 995, secure: true },
      usePOP3: false
    },
    'sina': {
      name: '新浪邮箱',
      domains: ['sina.com', 'sina.cn'],
      smtp: { host: 'smtp.sina.com', port: 587, secure: false },
      imap: { host: 'imap.sina.com', port: 993, secure: true },
      pop3: { host: 'pop.sina.com', port: 995, secure: true },
      usePOP3: false
    },
    'sohu': {
      name: '搜狐邮箱',
      domains: ['sohu.com'],
      smtp: { host: 'smtp.sohu.com', port: 25, secure: false },
      imap: { host: 'imap.sohu.com', port: 993, secure: true },
      pop3: { host: 'pop.sohu.com', port: 995, secure: true },
      usePOP3: false
    }
  };

• index.js:354-355 (registration)

  Dispatch case in the CallToolRequestSchema handler that routes calls to the listSupportedProviders method.

  case 'list_supported_providers':
    return await this.listSupportedProviders(args);