Wake MCP

AI Agent 状态通知到微信

关注服务号
微信搜索并关注「星河奔码」服务号

获取 API Token
关注后自动收到专属 Token，回复 token 可随时查看

配置 MCP
在 AI IDE 中添加 MCP Server，填入 API URL 和 Token

第一步 · 安装 uv（仅首次）

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

第二步 · MCP 配置（零安装，推荐）

{
  "mcpServers": {
    "wake-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "https://wake.advben.top/download/wake_mcp-0.1.0-py3-none-any.whl",
        "wake-mcp"
      ],
      "env": {
        "WAKE_MCP_API_URL": "https://wake.advben.top",
        "WAKE_MCP_USER_TOKEN": "你的Token"
      }
    }
  }
}

方式二 · pip 安装（免装 uv）

# 1. 安装
pip install https://wake.advben.top/download/wake_mcp-0.1.0-py3-none-any.whl

# 2. 查询 wake-mcp 命令的绝对路径
where.exe wake-mcp        # Windows
which wake-mcp            # macOS / Linux

# 3. 用绝对路径配置（示例为 Windows）
{
  "mcpServers": {
    "wake-mcp": {
      "command": "C:\\Python311\\Scripts\\wake-mcp.exe",
      "env": {
        "WAKE_MCP_API_URL": "https://wake.advben.top",
        "WAKE_MCP_USER_TOKEN": "你的Token"
      }
    }
  }
}

TRAE IDE Cursor Claude Desktop VS Code (Cline) Windsurf

自动通知规则

将下方规则复制后，粘贴到你的 AI IDE 的 Rules 配置中（TRAE / Cursor 项目规则、Claude 的 CLAUDE.md 等），AI 即会在关键时刻自动推送微信通知。

在项目中工作时，遇到以下关键时刻，AI 会自动调用 send_wechat_notify 工具通知你：

时刻	event_type	触发条件
任务完成	`任务完成`	完成一项任务或阶段性目标
发生异常	`任务异常`	运行中捕获到异常、报错、崩溃
执行失败	`任务失败`	测试未通过、构建失败、命令执行失败
需要决策	`需要决策`	遇到需用户拍板的分叉点、歧义或权限确认

title：简洁标题（≤20 字），如「登录接口开发完成」
content：具体说明（≤20 字），概括做了什么或问题是什么
event_type：从上表选择对应中文取值
project：当前项目名称，留空则自动取工作目录名
微信模板 thing 字段限制 20 字，title 和 content 都要精简
只在上述四类关键时刻通知，避免打扰；一次连续操作只在最终结果时通知一次

# Wake MCP 自动通知规则

当在本项目中工作时，遇到以下关键时刻，必须调用 `send_wechat_notify` 工具通知用户：

| 时刻 | event_type 取值 | 触发条件 |
|------|----------------|---------|
| 任务完成 | `任务完成` | 完成用户交代的一项任务或阶段性目标 |
| 发生异常 | `任务异常` | 运行中捕获到异常、报错、崩溃 |
| 执行失败 | `任务失败` | 测试未通过、构建失败、命令执行失败 |
| 需要决策 | `需要决策` | 遇到需要用户拍板的分叉点、歧义或权限确认 |

## 调用约定

- `title`：简洁标题（≤20 字），如「登录接口开发完成」
- `content`：具体说明（≤20 字），概括做了什么或问题是什么
- `event_type`：从上表选择对应中文取值
- `project`：当前项目名称，留空则自动取工作目录名

## 注意

- 微信模板 `thing` 字段限制 20 字，`title` 和 `content` 都要精简
- 不要在每一个小步骤都通知，只在上述四类关键时刻通知，避免打扰
- 一次连续操作只在最终结果时通知一次