MCP 服务器

mcp-mail-notifier

Sends task completion notifications via QQ email with time tracking, compatible with Augment's MCP protocol.

README

mcp-mail-notifier Notification MCP Server

将 mcp-mail-notifier 项目的邮件通知功能转换为 Augment 可用的 MCP (Model Context Protocol) 工具。

功能特性

📧 邮件通知: 发送任务完成通知到指定邮箱
⏱️ 时间跟踪: 自动计算任务耗时
🎯 项目集成: 专为 mcp-mail-notifier 项目定制
🔧 MCP 兼容: 完全兼容 Augment 的 MCP 协议
✅ QQ邮箱优化: 专门优化QQ邮箱SMTP配置
✅ 中文支持: 中文时区和格式化支持

安装

1. 安装依赖

cd mcp-tools
npm install

2. 获取QQ邮箱授权码

登录QQ邮箱 (https://mail.qq.com)
点击"设置" -> "账户"
找到"POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务"
开启"IMAP/SMTP服务"
获取授权码（不是QQ密码）

3. 配置环境变量（可选）

export QQ_EMAIL_USER="your-email@qq.com"
export QQ_EMAIL_AUTH_CODE="your-auth-code"

如果不设置环境变量，将使用默认配置。

使用方法

作为 MCP 服务器运行

npm start

直接使用命令行工具

node send-notification.js "任务标题" "任务结果" "详细信息" "开始时间"

示例：

node send-notification.js "iOS应用编译" "成功" "编译完成，所有测试通过" "2024-01-01 10:00:00"

配置 Augment

在 Augment 中配置 MCP 连接：

{
  "mcpServers": {
    "mcp-mail-notifier": {
      "command": "node",
      "args": [
        "/path/to/your/project/mcp-tools/mcp-server.js"
      ],
      "env": {
        "QQ_EMAIL_USER": "your-qq-email@qq.com",
        "QQ_EMAIL_AUTH_CODE": "your-authorization-code"
      }
    }
  }
}

MCP 工具说明

1. send_notification

发送任务完成通知邮件。

参数：

task_title (必需): 任务标题
task_result (必需): 任务结果
details (可选): 详细信息
recipient (可选): 收件人邮箱
start_time (可选): 任务开始时间

示例：

{
  "task_title": "iOS项目文件结构重构",
  "task_result": "成功完成",
  "details": "已成功重构项目文件结构，创建Core目录统一管理核心组件",
  "start_time": "2025-09-07 00:30:00"
}

2. set_task_start_time

设置任务开始时间，用于后续计算任务耗时。

参数：

start_time (可选): 任务开始时间，不提供则使用当前时间

3. format_duration

格式化时间间隔显示。

参数：

seconds (必需): 秒数

配置说明

项目配置

在 send-notification.js 中的 PROJECT_CONFIG 部分：

const PROJECT_CONFIG = {
  name: 'mcp-mail-notifier',
  displayName: '📒【mcp-mail-notifier】',
  description: 'mcp-mail-notifier iOS应用'
};

邮件配置

在 send-notification.js 中的 EMAIL_CONFIG 部分：

const EMAIL_CONFIG = {
  recipient: 'xxx@qq.com',
  sender: {
    user: process.env.QQ_EMAIL_USER || 'xxx@qq.com',
    authCode: process.env.QQ_EMAIL_AUTH_CODE || 'your-auth-code'
  }
};

在 Augment 中使用

启动 MCP 服务器：
```
npm start
```
在 Augment 中配置 MCP 连接，指向这个服务器
使用工具：
- send_notification: 发送通知邮件
- set_task_start_time: 设置任务开始时间
- format_duration: 格式化时间显示