trae-pushplus-notify

TRAE AI 专用 MCP 推送工具 · 自动将任务状态推送到微信（PushPlus） 无配置文件、加密存储、单文件 exe 直接运行

✨ 功能特性

✅ TRAE MCP 原生支持 ✅ 微信实时通知（PushPlus） ✅ Token 加密存储（本机唯一，防泄露） ✅ 自定义推送标题 ✅ 无多余配置文件 ✅ 支持全局 npm 安装 ✅ 支持打包单文件 exe ✅ 美观 Emoji 格式化通知

🚀 快速开始

方式一：通过 npm 安装

1. 安装（全局）

npm install -g trae-pushplus-notify

2. 设置 PushPlus Token（仅一次）

trae-pushplus-notify config set token=你的PushPlusToken

成功后会显示：✅ Token 已保存

3. 可选：设置默认推送标题

trae-pushplus-notify config set title=TRAE任务通知

成功后会显示：✅ 默认标题已设置：自定义标题

4. 配置 TRAE（必须）

在你的项目中创建文件： .trae/mcp.json

{
  "mcpServers": {
    "trae-pushplus-notify": {
      "command": "trae-pushplus-notify",
      "args": ["mcp"]
    }
  }
}

重启 TRAE 即可自动加载 MCP 工具

方式二：直接使用打包好的 exe（无需 Node.js）

如果您已经打包了 trae-pushplus-notify.exe 文件，这是一个单文件可执行程序，无需安装 Node.js 环境即可运行。

1. 设置 PushPlus Token

获取 Token 请访问：https://www.pushplus.plus/

trae-pushplus-notify.exe config set token=你的PushPlusToken

成功后会显示：✅ Token 已保存

2. 设置默认推送标题（可选）

trae-pushplus-notify.exe config set title=自定义标题

成功后会显示：✅ 默认标题已设置：自定义标题

3. 配置 TRAE

在您的 TRAE 项目中创建文件： .trae/mcp.json

{
  "mcpServers": {
    "trae-pushplus-notify": {
      "command": "D:\\路径\\到\\trae-pushplus-notify.exe",
      "args": ["mcp"]
    }
  }
}

注意：路径中的反斜杠需要双写，或者使用正斜杠。

4. 重启 TRAE

重启 TRAE AI 后，它会自动加载 MCP 工具。

🤖 让 TRAE 自动推送

直接告诉 TRAE：

每次任务完成后，自动调用 sendTraeNotify 推送通知到微信

支持字段：

• messageTime 消息时间
• projectName 项目名称
• taskStatus 任务状态
• taskDesc 任务描述
• userCommand 用户指令
• pushTitle 自定义标题（可选）

📱 微信通知效果

⏰ 消息时间：2026-03-06 19:30:00
📁 项目名称：my-project
📝 任务状态：执行成功
💬 任务摘要：已完成代码生成与保存
⌨️ 用户指令：帮我写一个MCP服务器
💡 此通知由 TRAE 任务自动发送

📋 命令汇总

| 命令 | 功能 | |------|------| | trae-pushplus-notify config set token=xxx | 设置 PushPlus Token | | trae-pushplus-notify config set title=xxx | 设置默认推送标题 | | trae-pushplus-notify config reset | 恢复默认设置（清除存储的 PushPlus Token、自定义推送标题） | | trae-pushplus-notify test |向 PushPlus 发送测试消息（需先设置 PushPlus Token） | | trae-pushplus-notify mcp | 启动 MCP 服务器（TRAE AI 会自动调用） |

📦 打包为单文件 EXE（Windows）

环境要求

• Node.js >= 18
• npm
• pkg >= 5.8.1

打包命令

# 1. 构建项目
npm run build

# 2. 打包为 exe
npx pkg dist/index.js --targets node18-win-x64 --output trae-pushplus-notify.exe

生成 trae-pushplus-notify.exe，无依赖、直接分发

🔐 安全说明

• Token 使用 AES-256-CBC 加密 存储
• 密钥与当前电脑绑定，其他设备无法解密
• 不产生明文配置文件
• 不上传任何数据，仅调用 PushPlus 官方接口

❓ 常见问题

Q: 如何获取 PushPlus Token？

A: 访问 https://www.pushplus.plus/，注册登录后，在「我的」页面获取 Token。

Q: 通知没有收到怎么办？

A: 请检查：

1. PushPlus Token 是否正确设置，并且完成实名认证
2. 微信是否关注了「PushPlus 推送加」公众号
3. TRAE AI 配置是否正确

Q: 可以在多台电脑上使用同一个 Token 吗？

A: 可以，PushPlus Token 支持多设备使用。

📄 协议

MIT License PushPlus 官网：https://www.pushplus.plus