WAKE Protocol

WAKE MCP 服务

具备意志感知能力的知识执行——面向 AI Agent 的事后协议。

23 个工具 · SQLite + AES-256-GCM 加密 · 令牌认证

快速开始

# From source
pnpm install && pnpm run build
pnpm start              # stdio + dashboard on :3000
pnpm run start:http     # dashboard only (no stdio)
pnpm test               # 69 tests

# npx (no install needed)
npx wake-mcp-server
npx wake-mcp-server --http

# Global install
npm i -g wake-mcp-server
wake-mcp-server
wake-mcp-server --http

# Docker
docker build -t wake-mcp-server .
docker run -p 3000:3000 -v wake-data:/app/data wake-mcp-server

连接你的 Agent

Warp / Claude Desktop / Cursor——配置相同，文件位置不同：

客户端	配置文件
Warp	设置 → MCP
Claude Desktop	claude_desktop_config.json（位于 mcpServers 下）
Cursor	.cursor/mcp.json（位于 mcpServers 下）

使用 npx（推荐）：

{
  "wake-protocol": {
    "command": "npx",
    "args": ["wake-mcp-server"]
  }
}

或使用本地构建：

{
  "wake-protocol": {
    "command": "node",
    "args": ["<path>/wake-mcp-server/build/index.js"]
  }
}

通过 HTTP 连接任何 MCP 客户端：

http://localhost:<port>/mcp

默认端口为 3000。如果端口被占用，会自动递增。设置 WAKE_PORT 可覆盖默认值。查看控制台输出，获取实际 URL。

Agent 技能

SKILL.md——与平台无关的说明，指导任何 Agent 如何使用 WAKE：

• 所有者——自动发送心跳、以对话方式设置遗嘱、主动贡献知识
• 验证者——处理死亡确认
• 受益人——按层级限定访问权限、最终消息、交接包
• 执行者——EULOGY 管理、法律导出、终止状态、数据清除

让你的 Agent 读取 SKILL.md，或将其加入系统提示词。

协议

ACTIVE → VIGIL → EULOGY → REST

• ACTIVE——所有者在世。Agent 每次交互时调用 heartbeat。
• VIGIL——超过不活动阈值。等待验证者确认。
• EULOGY——继承流程正在执行。分层访问、Black Box、最终消息。
• REST——终止状态（归档/提炼/删除）。协议完成。

身份验证

令牌在 configure_will 期间生成一次。分为三种类型：

• 主令牌——所有者操作（heartbeat、configure、vigil）
• 验证者令牌——仅用于确认死亡
• 受益人令牌——每人一个，按层级限定范围（executor/beneficiary/memorial）

令牌以 SHA-256 哈希形式存储。状态使用 AES-256-GCM 加密（服务器密钥）。

工具

遗嘱管理

工具	身份验证	阶段	描述
configure_will	无	任意	创建遗嘱并生成所有令牌
update_will	主令牌	ACTIVE	修改遗嘱字段
heartbeat	主令牌	ACTIVE	表明所有者在世
get_status	可选	任意	协议状态（提供令牌时显示详细信息）

协议进展

工具	身份验证	阶段	描述
trigger_vigil	主令牌	ACTIVE	手动强制进入 VIGIL
verify_death	验证者令牌	VIGIL	确认死亡事件
execute_terminal_state	执行者令牌	EULOGY	执行归档/提炼/删除

数据访问

工具	身份验证	阶段	描述
get_access_tier	任意令牌	任意	检查令牌持有者的访问层级
get_final_message	任意令牌	EULOGY/REST	获取最终消息（考虑时间锁）
get_black_box	任意令牌	EULOGY/REST	获取已整理的知识，按层级限定范围
get_audit_log	执行者令牌	任意	完整审计记录

知识

工具	身份验证	阶段	描述
contribute_knowledge	主令牌	ACTIVE	添加知识条目（类别、摘要、详情）
list_knowledge	主令牌	ACTIVE	列出条目，可按类别筛选
delete_knowledge	主令牌	ACTIVE	删除条目

Agent 间交接

工具	身份验证	阶段	描述
initiate_handoff	执行者令牌	EULOGY/REST	为受益人生成交接包
get_handoff_package	任意令牌	EULOGY/REST	自助获取交接包（wake-handoff-v1 JSON）

备份与恢复

工具	身份验证	阶段	描述
export_will	执行者令牌	任意	导出加密状态数据块
import_will	无	任意	从导出的数据块导入
list_backups	执行者令牌	任意	列出自动备份快照
restore_backup	执行者令牌	任意	从备份恢复

法律与合规

工具	身份验证	阶段	描述
export_legal_will	executor	任意	符合 RUFADAA 的法律文件
purge_owner_data	executor	REST	永久删除所有数据（被遗忘权）
get_deletion_certificate	无	任意	清除数据后获取删除证明

主要功能

• 多用户 — 每个工具都接受 ownerId 参数，每位所有者的数据独立存储
• 自动备份 — 每次写入时保存之前的状态，保留最近 5 份
• 后台监控器 — 每 5 分钟检查一次心跳是否过期，并自动触发 VIGIL
• 死手开关 — 如果验证者没有响应，则自动将 VIGIL 升级为 EULOGY
• Webhook — 在 vigil.triggered、eulogy.started、eulogy.message、rest.executed、timelock.released 时触发
• 时间锁 — 消息和知识条目支持设置 releaseAfter，在指定日期前保持封存
• 脱敏过滤 — 匹配脱敏类别的条目对所有层级隐藏
• 按层级控制的 Black Box — executor 可查看全部内容；beneficiary 可查看财务、联系人和文档；memorial 仅可查看精选条目
• 禁止复活指令 — 可执行的标记，并会传递至交接内容和证明
• 司法管辖区映射 — 法律导出内容会映射至适用法律（RUFADAA、GDPR、ELVIS Act 等）
• 删除证明 — 经 SHA-256 证明的记录，是数据清除后唯一保留的内容

控制面板

Web UI 位于 http://localhost:3000。基于角色的视图：

• 登录 — 粘贴任意令牌，自动识别角色
• 所有者 — 状态、知识 CRUD、心跳、触发 VIGIL、法律导出
• 验证者 — 状态、确认死亡
• executor — Black Box、消息、审计、终止状态、交接、清除数据
• Beneficiary/Memorial — 按层级控制的 Black Box、消息

设置 WAKE_PORT=8080 可更改端口。

数据

SQLite 数据库位于 data/wake.db。服务端加密密钥位于 data/.server-key。删除证明位于 data/deletion-certificate-*.json。

删除 data/ 目录即可重置所有内容。

部署

一键部署：

CLI：

# Railway
railway init && railway up

# Fly.io
fly launch       # creates app + volume
fly deploy

# Docker
docker build -t wake-mcp-server .
docker run -p 3000:3000 -v wake-data:/app/data wake-mcp-server

Docker Compose：

services:
  wake:
    build: .
    ports: ["3000:3000"]
    volumes: ["wake-data:/app/data"]
volumes:
  wake-data:

包含配置文件：railway.toml、fly.toml、vercel.json、Dockerfile。

注意：Vercel 是无服务器平台，SQLite 数据不会持久保存。生产环境请使用 Railway 或 Fly。