WAKE Protocol

WAKE MCP Server

Will-Aware Knowledge Execution — AI エージェント向けの事後検証プロトコルです。

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

エージェントを接続する

Warp / Claude Desktop / Cursor — 同じ設定で、ファイルの場所はそれぞれ異なります。

クライアント	設定ファイル
Warp	Settings → 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 はコンソール出力で確認できます。

エージェントスキル

SKILL.md — あらゆるエージェントに WAKE の使い方を教える、プラットフォームに依存しない手順です。

• 所有者 — 自動ハートビート、対話形式での遺言設定、プロアクティブな知識提供
• 検証者 — 死亡確認の処理
• 受益者 — ティア別のアクセス、最終メッセージ、引き継ぎパッケージ
• 執行者 — EULOGY の管理、法的エクスポート、終端状態、データ消去

エージェントに SKILL.md を参照させるか、システムプロンプトに含めてください。

プロトコル

ACTIVE → VIGIL → EULOGY → REST

• ACTIVE — 所有者は存命です。エージェントは各対話で heartbeat を呼び出します。
• VIGIL — 非アクティブ状態のしきい値を超えました。検証者による確認を待機しています。
• EULOGY — 承継を実行中です。ティア別アクセス、Black Box、最終メッセージが利用できます。
• REST — 終端状態（アーカイブ／蒸留／削除）です。プロトコルが完了しています。

認証

トークンは configure_will の実行時に一度だけ生成されます。種類は 3 つです。

• Master — 所有者の操作（heartbeat、設定、vigil）
• Verifier — 死亡確認のみ
• Beneficiary — 個人ごとに発行され、ティア（executor／beneficiary／memorial）によって範囲が制限されます

トークンは SHA-256 ハッシュとして保存されます。状態は AES-256-GCM（サーバーキー）で暗号化されます。

ツール

遺言の管理

ツール	認証	フェーズ	説明
configure_will	なし	任意	遺言を作成し、すべてのトークンを生成
update_will	master	ACTIVE	遺言のフィールドを変更
heartbeat	master	ACTIVE	所有者が存命であることを通知
get_status	任意	任意	プロトコルの状態（トークンがある場合は詳細）

プロトコルの進行

ツール	認証	フェーズ	説明
trigger_vigil	master	ACTIVE	VIGIL を手動で強制
verify_death	verifier	VIGIL	死亡イベントを確認
execute_terminal_state	executor	EULOGY	アーカイブ／蒸留／削除を実行

データアクセス

ツール	認証	フェーズ	説明
get_access_tier	任意のトークン	任意	トークン保有者のティアを確認
get_final_message	任意のトークン	EULOGY/REST	最終メッセージを取得（時間ロックに対応）
get_black_box	任意のトークン	EULOGY/REST	コンパイル済みの知識を取得（ティア別に範囲を制限）
get_audit_log	executor	任意	監査ログ全体

ナレッジ

ツール	認証	フェーズ	説明
contribute_knowledge	master	ACTIVE	ナレッジエントリーを追加（カテゴリ、概要、詳細）
list_knowledge	master	ACTIVE	エントリーを一覧表示（カテゴリでの絞り込みは任意）
delete_knowledge	master	ACTIVE	エントリーを削除

エージェント間の引き継ぎ

ツール	認証	フェーズ	説明
initiate_handoff	executor	EULOGY/REST	受益者向けの引き継ぎパッケージを生成
get_handoff_package	任意のトークン	EULOGY/REST	セルフサービスで引き継ぎを取得（wake-handoff-v1 JSON）

バックアップと復旧

ツール	認証	フェーズ	説明
export_will	executor	任意	暗号化された状態データをエクスポート
import_will	なし	任意	エクスポート済みデータからインポート
list_backups	executor	任意	自動バックアップのスナップショットを一覧表示
restore_backup	executor	任意	バックアップから復元

法務・コンプライアンス

ツール	認証	フェーズ	説明
export_legal_will	executor	any	RUFADAA に準拠した法的文書
purge_owner_data	executor	REST	すべてのデータを完全に削除します（忘れられる権利）
get_deletion_certificate	none	any	消去後に削除証明書を取得します

主な機能

• マルチユーザー — すべてのツールに 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 で証明された記録で、データ消去後に唯一残るものです

ダッシュボード

http://localhost:3000 の Web UI です。役割に基づくビューを提供します。

• ログイン — 任意のトークンを貼り付けると、役割を自動検出します
• Owner — ステータス、ナレッジの CRUD、ハートビート、VIGIL のトリガー、法的エクスポート
• Verifier — ステータス、死亡の確認
• 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 を使用してください。