Email MCP Server

Instructions

Implementation Reference

• index.js:959-1015 (handler)

  The main handler function that executes the setup_email_account tool. It sets EMAIL_USER and EMAIL_PASSWORD environment variables, detects the email provider if not specified, auto-configures server settings using EMAIL_CONFIGS, and returns a success message with configuration details or an error.

  async setupEmailAccount(args) {
    const { email, password, provider } = args;
  
    // 设置用户名和密码
    process.env.EMAIL_USER = email;
    process.env.EMAIL_PASSWORD = password;
  
    let detectedProvider = provider;
    let config;
  
    try {
      // 如果没有指定提供商，则自动检测
      if (!detectedProvider) {
        detectedProvider = this.detectEmailProvider(email);
        if (!detectedProvider) {
          return {
            content: [{
              type: 'text',
              text: `❌ 无法识别邮箱类型: ${email}\n\n支持的邮箱类型请使用 list_supported_providers 查看，或手动指定 provider 参数。`
            }]
          };
        }
      }
  
      // 自动配置服务器设置
      config = this.autoConfigureByProvider(detectedProvider);
  
      let result = `✅ 邮箱账号设置成功！\n\n`;
      result += `📧 邮箱地址: ${email}\n`;
      result += `🏢 邮箱提供商: ${config.name}\n`;
      result += `📤 SMTP服务器: ${config.smtp.host}:${config.smtp.port} (SSL: ${config.smtp.secure})\n`;
      result += `📥 接收协议: ${config.usePOP3 ? 'POP3' : 'IMAP'}\n`;
      
      if (config.usePOP3) {
        result += `📥 POP3服务器: ${config.pop3.host}:${config.pop3.port} (SSL: ${config.pop3.secure})\n`;
      } else {
        result += `📥 IMAP服务器: ${config.imap.host}:${config.imap.port} (SSL: ${config.imap.secure})\n`;
      }
  
      result += `\n💡 提示: 配置已自动完成，您现在可以使用邮件功能了！`;
  
      return {
        content: [{
          type: 'text',
          text: result
        }]
      };
  
    } catch (error) {
      return {
        content: [{
          type: 'text',
          text: `❌ 邮箱设置失败: ${error.message}`
        }]
      };
    }
  }

• index.js:247-269 (registration)

  Registers the 'setup_email_account' tool in the MCP server's listTools response, including name, description, and input schema definition.

  {
    name: 'setup_email_account',
    description: '设置邮箱账号（自动识别邮箱类型并配置服务器）',
    inputSchema: {
      type: 'object',
      properties: {
        email: {
          type: 'string',
          description: '邮箱地址（如 user@qq.com）'
        },
        password: {
          type: 'string',
          description: '邮箱密码或授权码'
        },
        provider: {
          type: 'string',
          enum: ['qq', '163', 'gmail', 'outlook', 'exmail', 'aliyun', 'sina', 'sohu'], // 暂时注释掉: 'netease-enterprise'
          description: '邮箱提供商（可选，不填写则自动识别）'
        }
      },
      required: ['email', 'password']
    }
  },

• index.js:352-353 (registration)

  In the CallToolRequestSchema handler, dispatches calls to 'setup_email_account' to the setupEmailAccount method.

  case 'setup_email_account':
    return await this.setupEmailAccount(args);

• index.js:111-131 (helper)

  Helper method to detect email provider from email domain or manual type, used by setupEmailAccount.

  detectEmailProvider(email, manualType = null) {
    // 优先使用手动指定的邮箱类型
    if (manualType && EMAIL_CONFIGS[manualType]) {
      console.log(`使用手动指定的邮箱类型: ${manualType} (${EMAIL_CONFIGS[manualType].name})`);
      return manualType;
    }
  
    // 如果没有手动指定，则根据域名自动检测
    const domain = email.split('@')[1]?.toLowerCase();
    if (!domain) return null;
    
    for (const [provider, config] of Object.entries(EMAIL_CONFIGS)) {
      if (config.domains.includes(domain)) {
        console.log(`自动检测到邮箱类型: ${provider} (${config.name})`);
        return provider;
      }
    }
    
    console.log(`未能识别邮箱类型，域名: ${domain}`);
    return null;
  }

• index.js:134-159 (helper)

  Helper method that sets environment variables for email servers based on the detected provider, used by setupEmailAccount.

  autoConfigureByProvider(provider) {
    const config = EMAIL_CONFIGS[provider];
    if (!config) {
      throw new Error(`不支持的邮箱类型: ${provider}`);
    }
  
    // 设置SMTP配置
    process.env.EMAIL_SMTP_HOST = config.smtp.host;
    process.env.EMAIL_SMTP_PORT = config.smtp.port.toString();
    process.env.EMAIL_SMTP_SECURE = config.smtp.secure.toString();
  
    // 设置IMAP配置
    process.env.EMAIL_IMAP_HOST = config.imap.host;
    process.env.EMAIL_IMAP_PORT = config.imap.port.toString();
    process.env.EMAIL_IMAP_SECURE = config.imap.secure.toString();
  
    // 设置POP3配置
    process.env.EMAIL_POP3_HOST = config.pop3.host;
    process.env.EMAIL_POP3_PORT = config.pop3.port.toString();
    process.env.EMAIL_POP3_SECURE = config.pop3.secure.toString();
  
    // 设置协议偏好
    process.env.EMAIL_USE_POP3 = config.usePOP3.toString();
  
    return config;
  }